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 → 🇳🇬 NGN
Local-to-local naira payout with BVN checks and instant settlement.
🇳🇬 NGN → 🇺🇸 USD
Send naira to a US bank, covering FX, fees, and compliance steps.
🇳🇬 NGN → 🇪🇺 EUR
Move NGN funds into a euro account and handle required documents.
🇳🇬 NGN → 🇬🇧 GBP
Walk through payouts to the UK and sort-code validation basics.
🇳🇬 NGN → 🇨🇦 CAD
Route NGN disbursements to Canada either via bank transfer or Interac.
🇲🇼 MWK → 🇲🇼 MWK
Run domestic Malawi payouts and reuse saved recipients easily.
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. - 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.