Developers / Guides

Run payout batches

Queue thousands of payouts from a file or the API and approve them under maker-checker.

7 min read · updated 2026-10-02 · API 2026-06-01

Create a batch

POST a batch with up to 20,000 payout lines. Each line references a destination token and an amount. Lines validate immediately: unknown destinations and blocked currencies fail before approval, not after.

Approve under maker-checker

A second user with payout approval rights reviews the batch summary and approves. Program rules decide who may prepare versus approve; the API enforces both roles.

Respect cut‑offs

Each rail exposes its cut‑off names through /v1/cutoffs. Batches submitted before cut‑off leave the same day; the response states the arrival estimate per rail.

Test mode needs no approval

Request a demo key and follow this guide against your own flows.