Sign inGet sandbox access →
FAQ

How do I send many payouts at once?

You send a mass payout by fanning out over the single-payout endpoint, POST /api/v1/payouts — one call per recipient. There is no batch endpoint: a run of a thousand payments is the same request you make for one, repeated a thousand times. Each call carries that recipient's currency, amount, destination address, and its own idempotency_key in the request body, and each resulting payout enters pending_approval until an operator releases it. The shape of the work is a loop over your recipient list, not a single bulk submission.

related

Keep reading across the cluster.

halfin FAQ — how crypto payments work end to endHow halfin invoicing, checkout, deposit addresses, payouts, conversion, and webhooks work. Browse every question or read the cross-cutting answers.Is there a dedicated batch payout endpoint?No. A halfin mass payout is a fan-out over the single-payout API: call POST /api/v1/payouts once per recipient, each with its own idempotency key.Is there a limit on a mass payout run?There is no batch object to cap. A run is a fan-out you drive from your side, so its size is bounded by your own pacing — respect the API's rate limits with backoff.Are API keys scoped?Yes. A halfin API key carries only the permissions you grant it, scoped to the operations it needs — a read or invoice key cannot release payouts.Are API requests rate limited?Yes. Public auth endpoints are rate limited per IP and authenticated API-key requests are limited too. Design clients to back off and retry idempotently.Are crypto payments final?Yes — a confirmed on-chain transfer is irreversible and there are no chargebacks. Finality is a property of the chain, which is what makes reconciliation clean.Are there chargebacks with crypto payments?No. A confirmed on-chain payment is final, so there are no card-style forced reversals. A refund is a deliberate action you choose to issue.Are there monthly or setup fees?halfin's commercial pricing is not published on this site yet, so there is no monthly or setup figure to quote here. Building in the sandbox is free.Assets and networks questionsFrequently asked questions drawn from the halfin assets and networks pages. Each one links to a standalone answer.Can a customer pay an invoice late?A deposit that lands after a halfin invoice expires fires invoice.late_deposit — the funds are credited and matched to the invoice, and you decide how to treat the order.Can a customer reuse the same deposit address?Yes. A halfin static deposit address is persistent, so repeat deposits to the same address credit the same customer — no new invoice or address per top-up.Can I auto-convert incoming payments to a stablecoin?Yes. halfin balance conversion can run automatically toward a target asset such as a stablecoin, so incoming payments settle in one currency on credit.