Sends one or more AED payouts to UAE bank accounts in a single request. Put each payout in the disbursements array with an amount and a reason.

For each payout, either send raw bank details (first_name_or_business_name, last_name and the IBAN in account), or send recipient_id from Create recipient and the recipient's saved bank details are used. A saved recipient must have a UAE bank account; for other countries use Create international payout.

Rules

• Each payout must be at least AED 10.
• The batch total (excluding payout fees) must not exceed your available balance. If your plan has a payout fee, it is then charged on top, per payout.
• The batch is all or nothing. If any row is invalid, no payouts are created and the 422 response lists each problem as Row N is invalid: .... Row and balance errors come in messages, with no errors array.

The response is the list of created payouts, usually with status Processing. Track each one with Fetch payout info or the payout.processed and payout.failed webhooks; see the Payout object.

📘

Retry safely

Send an Idempotency-Key header so a retried request can't create the batch twice. See Idempotency.