Skip to main content

Disbursements

Bulk withdrawals (a.k.a. disbursements) are the core payout feature served directly by payments-backend. A batch is uploaded, optionally fee-quoted, approved, then processed into individual withdrawals. Beneficiaries can be saved for reuse.

Everything on this page is served by payments-backend itself (not proxied), so the request and response schemas below come straight from the code.

What's here​

  • Batches — create, list, fetch, approve, cancel, relabel, and fee-quote a batch.
  • Withdrawals — list the withdrawals in a batch or across the account.
  • Beneficiaries — create (single or bulk), list, fetch, update and delete saved recipients.
  • Banks & totals — supported banks, pending totals, and the paid-disbursement summary.

All routes require a user JWT (role management:user); writes additionally require the X-USER-UNIQUE-ID header, and creating a batch also requires X-VALR-Entity-Id.