PayoutsReference

Supported Destinations

Currencies, countries, and payout rails

The Payouts API supports payouts in fiat currencies and stablecoins. The table below maps each supported fiat currency to typical country(ies) and whether bank and/or mobile wallet rails are available.

Destination Overview

CurrencyCountry (typical)BankMobile walletNotes
NGNNigeriaYesYesNIBSS; bank code via bankCode in recipient. Mobile wallet: OPay (opay).
XOFWest African CFA (e.g. Senegal, Côte d’Ivoire)YesYesmtn, orange, airtel, moov, wave.
XAFCentral African CFA (e.g. Cameroon, Gabon)YesYesmtn, orange, moov.
GHSGhanaYesYesMTN (mtn) and other supported wallets.
KESKenyaYesYesM-Pesa (mpesa), Airtel (airtel). Sender required. See Kenya.
TZSTanzaniaYesYesMTN (mtn), Airtel (airtel).
UGXUgandaYesYesMTN (mtn).
ZARSouth AfricaYes—Bank transfers.
EGPEgyptYesYesBank; bankCode required; IBAN supported. Sender required. Wallets: Fawry (fawry). See Egypt.

Use this as a quick reference for “where can I send?” and which payment method to use:

  • Bank: Use Bank Transfers — paymentMethodId: "banktransfer", recipient.type: "bank_account".
  • Mobile wallet: Use Mobile Wallet — paymentMethodId: "mobilemoney", recipient.type: "mobile_money".
  • Stablecoin: Use Stablecoin Payouts — paymentMethodId: "crypto", recipient.type: "crypto_wallet".

Destination is determined by the currency in destinationValue.currency and the paymentLocation field (3-letter ISO country code). Fiat payouts use the currencies listed above.

Stablecoin Payouts (Crypto Wallets)

CurrencyNetworksRecipient TypeNotes
USDTERC20, TRC20crypto_walletpaymentMethodId: "crypto"
USDCERC20, TRC20crypto_walletpaymentMethodId: "crypto"

Market-Specific Requirements (Quick Notes)

  • Egypt (EGP): Bank payouts require bankCode; IBAN is supported. Sender is required for Egypt payouts (bank and wallet). Wallets use operator: "fawry". See Egypt for bank codes, sender fields, formats, and status behaviour.
  • Ghana (GHS): No additional fields beyond standard bank/mobile wallet requirements; use operator: "mtn" for MTN wallets.
  • Kenya (KES): Sender is required for Kenya payouts (bank and mobile wallet). M-Pesa uses operator: "mpesa". See Kenya for sender fields and examples.
  • Tanzania (TZS): No additional fields beyond standard requirements; use operator: "mtn" or operator: "airtel" for wallets.
  • Uganda (UGX): No additional fields beyond standard requirements; use operator: "mtn" for MTN wallets.
  • Francophone (XOF/XAF): No additional fields beyond standard requirements; choose the correct operator for the recipient (see Mobile Wallet and the Francophone sandbox guide).
  • Stablecoins (USDT/USDC): Use recipient.type: "crypto_wallet" with address and network (ERC20 or TRC20). memo is optional but required by some wallets.

Next Steps