Payroll or bulk payouts

If you pay the same list of people every cycle — employees, suppliers, sellers — use the Batch Transfers feature in the Dashboard instead of calling the API in a loop.

Why batch

  • One CSV with up to 5,000 rows, validated before anything moves.
  • A human can review the total before approving.
  • MFA-gated authorization.
  • Each row fires normal transfer.outbound.* webhooks, so your reconciliation code stays the same.
flowchart LR
    CSV[CSV up to 5,000 rows] --> Upload[Upload + validate]
    Upload --> Auth[pending_authorization]
    Auth -->|MFA| Run[in_progress]
    Run --> Done[succeeded · partially_succeeded · failed]

When to use it

  • Monthly payroll.
  • Supplier runs and commission payouts.
  • Any batch of 10 – 5,000 transfers a human should review before releasing.

Where to go

Full step-by-step (template download, column reference, authorization flow, statuses): Batch Transfers.


What’s Next