Jump to Content

Request Parameters

Country Reference Table

Country	Country Code	Currency	Purpose (Payin)	Purpose (Payout)	Special Fields
Kenya	`KE`	`KES`	`MPESA`, `AIRTEL`	`MPESA`, `AIRTEL`	—
Tanzania	`TZ`	`TZS`	`AIRTEL`, `EZY`, `HOLA`, `TPESA`, `TIGO`, `VODACOM`, `SELCOME`	`AIRTEL`, `EZY`, `HOLA`, `TPESA`, `TIGO`, `VODACOM`, `SELCOME,Bank-Payout`	—
Uganda	`UG`	`UGX`	`AIRTEL`, `MTN`	`AIRTEL`, `MTN`	—
Ghana	`GH`	`GHS`	`AIRTEL`, `MTN`, `VODAFONE`	`AIRTEL`, `MTN`, `VODAFONE`	—
Nigeria	`NG`	`NGN`	`BANK TRANSFER`, `OPAY`, `PALMPAY`	`BANK TRANSFER`, `OPAY`, `PALMPAY`	—
Zambia	`ZM`	`ZMW`	`AIRTEL`, `MTN`, `ZAMTEL`	`AIRTEL`, `MTN`, `ZAMTEL`	—
Rwanda	`RW`	`RWF`	`AIRTEL`, `MTN`	`AIRTEL`, `MTN`	`account_name` required
Egypt	`EG`	`EGP`	`WALLET`, `CASH`	`CASH`	Payin only
South Africa	`ZA`	`ZAR`	`EFT`	`EFT`	`purpose` not required
XOF Zone — Burkina Faso	`BF`	`XOF`	`ORANGE`, `WAVE`, `MOOV`	`ORANGE`, `WAVE`, `MOOV`	Use country-specific code
XOF Zone — Côte d'Ivoire	`CI`	`XOF`	`ORANGE`, `WAVE`, `MOOV`, `MTN`	`ORANGE`, `WAVE`, `MOOV`, `MTN`	Use country-specific code
XOF Zone — Senegal	`SN`	`XOF`	`ORANGE`, `WAVE`, `FREE MONEY`	`ORANGE`, `WAVE`, `FREE MONEY`	Use country-specific code
XOF Zone — Togo	`TG`	`XOF`	`MOOV`, `TMONEY`	`MOOV`, `TMONEY`	Use country-specific code
XOF Zone — Benin	`BN`	`XOF`	`MOOV`	`MOOV`	Use country-specific code
XAF Zone — Cameroon	`CM`	`XAF`	`ORANGE`, `MTN`	`ORANGE`, `MTN`	Use country-specific code

Country-Specific Notes

Kenya

Provider: Safaricom M-PESA, Airtel
Both payin and payout use "purpose": "MPESA" or "purpose": "AIRTEL"
Phone numbers should be in the format 2547XXXXXXXX

Tanzania

Providers: Airtel, EZY, Hola, T-PESA, Tigo, Vodacom, Selcom
Both payin and payout support: AIRTEL, EZY, HOLA, TPESA, TIGO, VODACOM, SELCOME

Uganda

Providers: Airtel, MTN Mobile Money
Both payin and payout use "purpose": "AIRTEL" or "purpose": "MTN"

Ghana

Providers: Airtel, MTN Mobile Money, Vodafone
Both payin and payout support: AIRTEL, MTN, VODAFONE

Nigeria

Providers: Bank Transfer, OPay, PalmPay
Use "purpose": "BANK TRANSFER", "purpose": "OPAY", or "purpose": "PALMPAY"
The provider is selected by Centiwise based on the account number or phone

Zambia

Providers: Airtel, MTN Mobile Money, Zamtel
Both payin and payout support: AIRTEL, MTN, ZAMTEL

Rwanda

⚠️
Rwanda requires an additional field.

Providers: Airtel, MTN Mobile Money
Both Payin and Payout requests must include account_name (the full name of the account holder)
Both payin and payout support: AIRTEL, MTN

Egypt

📝
Egypt

Providers: Wallet, Cash (Fawry)
Payin uses "purpose": "WALLET" or "purpose": "CASH"
Payout is currently supported on CASH only— contact your account manager

South Africa

📝
South Africa does not use a purpose field.

Provider: EFT
Omit purpose from both Payin and Payout requests
Currency: ZAR

XOF Zone (Burkina Faso, Côte d'Ivoire, Senegal, Togo, Benin)

All five countries share the XOF currency
Set the country field to the specific two-letter code of the customer's country (e.g. "country": "CI" for Côte d'Ivoire)

Country	Code	Payin & Payout Purposes
Burkina Faso	`BF`	`ORANGE`, `WAVE`, `MOOV`
Côte d'Ivoire	`CI`	`ORANGE`, `WAVE`, `MOOV`, `MTN`
Senegal	`SN`	`ORANGE`, `WAVE`, `FREE MONEY`
Togo	`TG`	`MOOV`, `TMONEY`
Benin	`BN`	`MOOV`

XAF Zone (Cameroon)

Provider: Orange Money, MTN Mobile Money
Currency: XAF
Set "country": "CM" for Cameroon
Both payin and payout support: ORANGE, MTN

Updated 5 months ago

Did this page help you?