quoteId, ensuring the exchange rate, fees, and limits applied during quoting remain intact at execution time.
Payout lifecycle
Operational considerations
- Quotes are mandatory: Always create a quote first and reuse the
quoteIdduring payout creation. - Idempotency: Use client-generated references to safely retry payouts without double-paying.
- Webhooks: Treat the synchronous payout response as an acknowledgement. The final status arrives via payout webhook.
- Compliance rules: Review the
rulesarray on the quote to enforce per-corridor limits in your UI.
Payout API Routes
π³π¬ NGN Payout
Local-to-local naira payout with BVN checks and instant settlement.
πΊπΈ USD Payout
Send US Dollars to a US bank account globally.
πͺπΊ EUR Payout
Move Euros to a EUR bank account globally.
π¬π§ GBP Payout
Send Great British Pounds to a UK bank account globally.
π¨π¦ CAD Payout
Send Canadian Dollar to a Canadian bank account globally.
π²πΌ MWK Payout
Send Malawian Kwacha to a Malawian bank account.
π·πΌ RWF Payout
Send Rwandan Franc to a Rwandan bank account globally.
π¨π³ CNY Payout
Send Chinese Yuan to a Chinese bank account globally.
π»π³ VND Payout
Send Vietnamese Dong to a Vietnamese bank account globally.
Next steps
- Create a payout with
POST /v2/payout. - Send to multiple recipients at once with the
Bulk Payout APIβ ideal for payroll, vendor payments, and mass disbursements. - Get bank list
- Explore corridor-specific payloads with the example cards above or jump straight to the
payout docs examples. - Monitor disbursement states using the
Get Transaction API.

