Request Examples
Complete, copy-paste-ready request bodies for every supported country. Replace placeholder values with real data before sending.
| Country Name | Purpose (MNO) | Transaction Type |
|---|---|---|
| Kenya | M-PESA, Airtel | Payin and Payout |
| Tanzania | Vodacom, Tigo, Airtel, Halotel, T-Pesa | Payin and Payout |
| Uganda | MTN, Airtel | Payin and Payout |
| Cameroon (XAF) | MTN, Orange | Payin and Payout |
| Ghana | MTN, Airtel, Vodafone | Payin and Payout |
| Nigeria | Bank , OPay , PalmPay | Payin and Payout |
| Mozambique | MPESA | Payin Only |
| Zambia | MTN, Airtel, Zamtel | Payin and Payout |
| Rwanda | MTN, Airtel | Payin and Payout |
| Egypt | Cash, wallet | Payin and Payout |
| South Africa | ABSA Bidvest Bank Gro FNB Investec TymeBank | Payin and Payout* |
| Burkina Faso | MOOV, Orange, WAVE | Payin and Payout |
| Côte d’Ivoire | MTN, Orange, MOOV, WAVE | Payin and Payout |
| Senegal | Free Money, Orange, WAVE | Payin and Payout |
| Sierra Leone | Orange Money | Payin and Payout |
| Republic of the Congo (XAF) | Airtel Money, MTN MoMo | Payin and Payout |
| Democratic Republic of the Congo (USD) | Airtel Money, Orange Money, Vodacom | Payin and Payout |
| Democratic Republic of the Congo (CDF) | Airtel Money, Orange Money, Vodacom | Payin and Payout |
| Gabon | Airtel Money | Payin and Payout |
| Benin | MOOV, MTN MoMo | Payin and Payout |
Notes:
For the french speaking countries, replace
"country": "CI"withBF,SN,GN, orBNfor other XOF countries. Keep"currency": "XOF"and"purpose": "ORANGE" or "MOOV" (As hightlighted on the above table).
Kenya
Payin (M-PESA, Airtel)
POST https://gate.centiwise.com/paynet/api/v2/sale-form/EndpointID
or
POST https://gate.centiwise.com/paynet/api/v2/sale/EndpointID
Parameters: 18
address1: 201 Trent Pines 24737 North Cecilyside West Virginia KR
amount: 10.00
city: North Cecilyside
client_orderid: f1727c7b-5fb9-4a29-b388-15549f852072
control: df06269ed872217082f41004a7c1ea55e7f60b2c
country: KE
currency: KES
email: [email protected]
first_name: Doreen
ipaddress: 36.0.38.223
last_name: Wekesa
merchant_data: deposit
order_desc: order
phone: 254759**8347
purpose: MPESA or AIRTEL
redirect_url: https://test.com/profile/refill
server_callback_url: https://test.com/payment/v1/287e42ec-fa99-4063-b995-7c113755ed21/callback_with_identity_common
zip_code: 24737Payout (M-PESA, Airtel)
POST https://gate.centiwise.com/paynet/api/v4/payout/EndpointID
Parameters: 14
account_name: SAMUEL WANJALA
account_number: 254792**8769
amount: 1297.89
client_orderid: 1336215908
currency: KES
ipaddress: 105.164.128.124
order_desc: 1f0424fb-9cbf-4f75-bb03-3aa3c97322d4:attempt-1
purpose: MPESA
receiver_email: [email protected]
receiver_first_name: SAMUEL
receiver_last_name: WANJALA
receiver_phone: 254792**8769
redirect_url: https://test.com/api/apm/response/CentiwiseAPM/dWJ6OHYxeU56b3k2eklnNGpySUt4Zz09
server_callback_url: https://test.com/api/apm/response/CentiwiseAPM/dWJ6OHYxeU56b3k2eklnNGpySUt4Zz09Rwanda
Payin (MTN, Airtel)
POST https://gate.centiwise.com/paynet/api/v2/sale-form/EndpointID
or
POST https://gate.centiwise.com/paynet/api/v2/sale/EndpointID
Parameters: 18
address1: 201 Trent Pines 24737 North Cecilyside West Virginia KR
amount: 50.00
city: North Cecilyside
client_orderid: f1727c7b-5fb9-4a29-b388-15549f852072
control: df06269ed872217082f41004a7c1ea55e7f60b2c
country: RW
currency: RWF
email: [email protected]
first_name: Doreen
ipaddress: 36.0.38.223
last_name: Wekesa
merchant_data: deposit
order_desc: order
phone: 250759**8347
purpose: MTN, Airtel
redirect_url: https://test.com/profile/refill
server_callback_url: https://test.com/payment/v1/287e42ec-fa99-4063-b995-7c113755ed21/callback_with_identity_common
zip_code: 24737Payout (MTN, Airtel)
POST https://gate.centiwise.com/paynet/api/v4/payout/EndpointID
Parameters: 15
account_name: hussein sheib
account_number: 250**0999
amount: 262900.00
client_orderid: 1335731814
currency: RWF
ipaddress: 136.158.50.100
order_desc: order_1792780573
purpose: AIRTEL
receiver_country_code: RW
receiver_email: [email protected]
receiver_first_name: Hussein
receiver_last_name: Sheib
receiver_phone: 250**09Tanzania
Payin (Vodacom, Tigo, Airtel, Halotel, T-Pesa)
POST https://gate.centiwise.com/paynet/api/v2/sale-form/EndpointID
or
POST https://gate.centiwise.com/paynet/api/v2/sale/EndpointID
Parameters: 17
address1: GULWE, CHISEYU ZAHANATI, 4163
amount: 182840.00
city: GULWE
client_orderid: 1335642286
control: d5870a014ee841664a47473b399805c3be287d26
country: TZ
currency: TZS
email: [email protected]
first_name: Lwidiko
ipaddress: 197.250.144.211
last_name: Daudi
order_desc: 175131-1792750907
phone: +25562xxxx444
purpose: HALOPESA
redirect_url: https://test.com/api/apm/response/CentiwiseAPM/U3JhOHh0bzhlbWFXMCt6Yzhja1RnQT09
server_callback_url: https://test.com/api/apm/response/CentiwiseAPM/U3JhOHh0bzhlbWFXMCt6Yzhja1RnQT09
zip_code: 4163Payout TZS(Vodacom, Tigo, Airtel, Halotel, T-Pesa)
POST https://gate.centiwise.com/paynet/api/v4/payout/EndpointID
Parameters: 15
account_name: hussein sheib
account_number: 255699**0999
amount: 262900.00
client_orderid: 1335731814
currency: TZS
ipaddress: 136.158.50.100
order_desc: order_1792780573
purpose: AIRTEL
receiver_country_code: TZ
receiver_email: [email protected]
receiver_first_name: Hussein
receiver_last_name: Sheib
receiver_phone: 255699**0999
redirect_url: https://test.com/api/apm/response/CentiwiseAPM/QjFNZ05lZUZXWlhldjN5akVHSG9oUT09
server_callback_url: https://test.com/api/apm/response/CentiwiseAPM/QjFNZ05lZUZXWlhldjN5akVHSG9oUT09Uganda
Payin (MTN, Airtel)
POST https://gate.centiwise.com/paynet/api/v2/sale-form/EndpointID
or
POST https://gate.centiwise.com/paynet/api/v2/sale/EndpointID
Parameters: 18
address1: 201 Trent Pines 24737 North Cecilyside West Virginia KR
amount: 500.00
city: North Cecilyside
client_orderid: f1727c7b-5fb9-4a29-b388-15549f852072
control: df06269ed872217082f41004a7c1ea55e7f60b2c
country: UG
currency: UGX
email: [email protected]
first_name: Doreen
ipaddress: 36.0.38.223
last_name: Wekesa
merchant_data: deposit
order_desc: order
phone: 256759**8347
purpose: MTN or AIRTEL
redirect_url: https://test.com/profile/refill
server_callback_url: https://test.com/payment/v1/287e42ec-fa99-4063-b995-7c113755ed21/callback_with_identity_common
zip_code: 24737Payout (MTN, Airtel)
POST https://gate.centiwise.com/paynet/api/v4/payout/EndpointID
Parameters: 15
account_name: hussein sheib
account_number: 25669**0999
amount: 262900.00
client_orderid: 1335731814
currency: UGX
ipaddress: 136.158.50.100
order_desc: order_1792780573
purpose: AIRTEL
receiver_country_code: UG
receiver_email: [email protected]
receiver_first_name: Hussein
receiver_last_name: Sheib
receiver_phone: 256699**0999
redirect_url: https://test.com/api/apm/response/CentiwiseAPM/QjFNZ05lZUZXWlhldjN5akVHSG9oUT09
server_callback_url: https://test.com/api/apm/response/CentiwiseAPM/QjFNZ05lZUZXWlhldjN5akVHSG9oUT09Ghana
Payin (MTN, Airtel, Vodafone)
POST https://gate.centiwise.com/paynet/api/v2/sale-form/EndpointID
or
POST https://gate.centiwise.com/paynet/api/v2/sale/EndpointID
Parameters: 18
address1: 201 Trent Pines 24737 North Cecilyside West Virginia KR
amount: 50.00
city: North Cecilyside
client_orderid: f1727c7b-5fb9-4a29-b388-15549f852072
control: df06269ed872217082f41004a7c1ea55e7f60b2c
country: GH
currency: GHS
email: [email protected]
first_name: Doreen
ipaddress: 36.0.38.223
last_name: Wekesa
merchant_data: deposit
order_desc: order
phone: 233759**8347
purpose: MTN or AIRTEL
redirect_url: https://test.com/profile/refill
server_callback_url: https://test.com/payment/v1/287e42ec-fa99-4063-b995-7c113755ed21/callback_with_identity_common
zip_code: 24737Payout (MTN, Airtel, Vodafone)
POST https://gate.centiwise.com/paynet/api/v4/payout/EndpointID
Parameters: 15
account_name: hussein sheib
account_number: 23369**0999
amount: 262900.00
client_orderid: 1335731814
currency: GHS
ipaddress: 136.158.50.100
order_desc: order_1792780573
purpose: AIRTEL
receiver_country_code: GH
receiver_email: [email protected]
receiver_first_name: Hussein
receiver_last_name: Sheib
receiver_phone: 233699**0999
redirect_url: https://test.com/api/apm/response/CentiwiseAPM/QjFNZ05lZUZXWlhldjN5akVHSG9oUT09
server_callback_url: https://test.com/api/apm/response/CentiwiseAPM/QjFNZ05lZUZXWlhldjN5akVHSG9oUT09Nigeria
Payin (Bank , OPay , PalmPay)
POST https://gate.centiwise.com/paynet/api/v2/sale-form/EndpointID
or
POST https://gate.centiwise.com/paynet/api/v2/sale/EndpointID
Parameters: 18
address1: 201 Trent Pines 24737 North Cecilyside West Virginia KR
amount: 50.00
city: North Cecilyside
client_orderid: f1727c7b-5fb9-4a29-b388-15549f852072
control: df06269ed872217082f41004a7c1ea55e7f60b2c
country: NG
currency: NGN
email: [email protected]
first_name: Doreen
ipaddress: 36.0.38.223
last_name: Wekesa
merchant_data: deposit
order_desc: order
phone: 234759**8347
purpose: Bank or OPay or PalmPay
redirect_url: https://test.com/profile/refill
server_callback_url: https://test.com/payment/v1/287e42ec-fa99-4063-b995-7c113755ed21/callback_with_identity_common
zip_code: 24737Payout (Bank / OPay / PalmPay)
When you choose bank, please find the list of banks in NGN.
POST https://gate.centiwise.com/paynet/api/v4/payout/EndpointID
Remote address: 54.151.217.67
Parameters: 12
account_name: Israel
account_number: 7045xxxx60
amount: 175005.15
bank_code: 305
bank_name: Opay
client_orderid: 51XO1EOGCWM9ONV3H30L
currency: NGN
phone: 07037950814
purpose: Bank or OPay or PalmPay
receiver_email: [email protected]
receiver_phone: 07037xxxx14
redirect_url: hhttps://test.com/profile/refill
server_callback_url: hthttps://test.com/profile/refillZambia
Payin (MTN, Airtel, Zamtel)
POST https://gate.centiwise.com/paynet/api/v2/sale-form/EndpointID
or
POST https://gate.centiwise.com/paynet/api/v2/sale/EndpointID
Parameters: 18
address1: 201 Trent Pines 24737 North Cecilyside West Virginia KR
amount: 50.00
city: North Cecilyside
client_orderid: f1727c7b-5fb9-4a29-b388-15549f852072
control: df06269ed872217082f41004a7c1ea55e7f60b2c
country: ZM
currency: ZMW
email: [email protected]
first_name: Doreen
ipaddress: 36.0.38.223
last_name: Wekesa
merchant_data: deposit
order_desc: order
phone: 260759**8347
purpose: MTN, Airtel, Zamtel
redirect_url: https://test.com/profile/refill
server_callback_url: https://test.com/payment/v1/287e42ec-fa99-4063-b995-7c113755ed21/callback_with_identity_common
zip_code: 24737Payout (MTN)
POST https://gate.centiwise.com/paynet/api/v4/payout/EndpointID
Parameters: 15
account_name: hussein sheib
account_number: 260**0999
amount: 262900.00
client_orderid: 1335731814
currency: ZMW
ipaddress: 136.158.50.100
order_desc: order_1792780573
purpose: AIRTEL
receiver_country_code: ZM
receiver_email: [email protected]
receiver_first_name: Hussein
receiver_last_name: Sheib
receiver_phone: 260699**0999
redirect_url: https://test.com/api/apm/response/CentiwiseAPM/QjFNZ05lZUZXWlhldjN5akVHSG9oUT09
server_callback_url: https://test.com/api/apm/response/CentiwiseAPM/QjFNZ05lZUZXWlhldjN5akVHSG9oUT09Mozambique
Payin (MPESA)
POST https://gate.centiwise.com/paynet/api/v2/sale-form/EndpointID
or
POST https://gate.centiwise.com/paynet/api/v2/sale/EndpointID
Parameters: 18
address1: 201 Trent Pines 24737 North Cecilyside West Virginia KR
amount: 50.00
city: North Cecilyside
client_orderid: f1727c7b-5fb9-4a29-b388-15549f852072
control: df06269ed872217082f41004a7c1ea55e7f60b2c
country: MZ
currency: MZN
email: [email protected]
first_name: Doreen
ipaddress: 36.0.38.223
last_name: Wekesa
merchant_data: deposit
order_desc: order
phone: 258759**8347
purpose: MPESA
redirect_url: https://test.com/profile/refill
server_callback_url: https://test.com/payment/v1/287e42ec-fa99-4063-b995-7c113755ed21/callback_with_identity_common
zip_code: 24737Payout (MTN, Airtel)
POST https://gate.centiwise.com/paynet/api/v4/payout/EndpointID
Parameters: 15
account_name: hussein sheib
account_number: 258**0999
amount: 262900.00
client_orderid: 1335731814
currency: MZN
ipaddress: 136.158.50.100
order_desc: order_1792780573
purpose: MPESA
receiver_country_code: MZ
receiver_email: [email protected]
receiver_first_name: Hussein
receiver_last_name: Sheib
receiver_phone: 258**0999
redirect_url: https://test.com/api/apm/response/CentiwiseAPM/QjFNZ05lZUZXWlhldjN5akVHSG9oUT09
server_callback_url: https://test.com/api/apm/response/CentiwiseAPM/QjFNZ05lZUZXWlhldjN5akVHSG9oUT09
SIERALEONE
Payin (ORANGE)
POST https://gate.centiwise.com/paynet/api/v2/sale-form/EndpointID
or
POST https://gate.centiwise.com/paynet/api/v2/sale/EndpointID
Parameters: 18
address1: 201 Trent Pines 24737 North Cecilyside West Virginia KR
amount: 50.00
city: North Cecilyside
client_orderid: f1727c7b-5fb9-4a29-b388-15549f852072
control: df06269ed872217082f41004a7c1ea55e7f60b2c
country: SL
currency: SLE
email: [email protected]
first_name: Doreen
ipaddress: 36.0.38.223
last_name: Wekesa
merchant_data: deposit
order_desc: order
phone: 232759**8347
purpose: ORANGE
redirect_url: https://test.com/profile/refill
server_callback_url: https://test.com/payment/v1/287e42ec-fa99-4063-b995-7c113755ed21/callback_with_identity_common
zip_code: 24737Payout (ORANGE)
POST https://gate.centiwise.com/paynet/api/v4/payout/EndpointID
Parameters: 15
account_name: hussein sheib
account_number: 232**0999
amount: 262900.00
client_orderid: 1335731814
currency: SLE
ipaddress: 136.158.50.100
order_desc: order_1792780573
purpose: ORANGE
receiver_country_code: SL
receiver_email: [email protected]
receiver_first_name: Hussein
receiver_last_name: Sheib
receiver_phone: 232**0999
redirect_url: https://test.com/api/apm/response/CentiwiseAPM/QjFNZ05lZUZXWlhldjN5akVHSG9oUT09
server_callback_url: https://test.com/api/apm/response/CentiwiseAPM/QjFNZ05lZUZXWlhldjN5akVHSG9oUT09
CAMEROON XAF
Payin (MTN, Orange)
POST https://gate.centiwise.com/paynet/api/v2/sale-form/EndpointID
or
POST https://gate.centiwise.com/paynet/api/v2/sale/EndpointID
Parameters: 18
address1: 201 Trent Pines 24737 North Cecilyside West Virginia KR
amount: 50.00
city: North Cecilyside
client_orderid: f1727c7b-5fb9-4a29-b388-15549f852072
control: df06269ed872217082f41004a7c1ea55e7f60b2c
country: CM
currency: XAF
email: [email protected]
first_name: Doreen
ipaddress: 36.0.38.223
last_name: Wekesa
merchant_data: deposit
order_desc: order
phone: 237759**8347
purpose: ORANGE
redirect_url: https://test.com/profile/refill
server_callback_url: https://test.com/payment/v1/287e42ec-fa99-4063-b995-7c113755ed21/callback_with_identity_common
zip_code: 24737Payout (MTN, Orange)
POST https://gate.centiwise.com/paynet/api/v4/payout/EndpointID
Parameters: 15
account_name: hussein sheib
account_number: 237**0999
amount: 262900.00
client_orderid: 1335731814
currency: XAF
ipaddress: 136.158.50.100
order_desc: order_1792780573
purpose: ORANGE
receiver_country_code: CM
receiver_email: [email protected]
receiver_first_name: Hussein
receiver_last_name: Sheib
receiver_phone: 237**0999
redirect_url: https://test.com/api/apm/response/CentiwiseAPM/QjFNZ05lZUZXWlhldjN5akVHSG9oUT09
server_callback_url: https://test.com/api/apm/response/CentiwiseAPM/QjFNZ05lZUZXWlhldjN5akVHSG9oUT09
Egypt
Payin (Wallet / CASH )
POST https://gate.centiwise.com/paynet/api/v2/sale-form/EndpointID
or
POST https://gate.centiwise.com/paynet/api/v2/sale/EndpointID
Parameters: 18
address1: 201 Trent Pines 24737 North Cecilyside West Virginia KR
amount: 50.00
city: North Cecilyside
client_orderid: f1727c7b-5fb9-4a29-b388-15549f852072
control: df06269ed872217082f41004a7c1ea55e7f60b2c
country: EG
currency: EGP
email: [email protected]
first_name: Doreen
ipaddress: 36.0.38.223
last_name: Wekesa
merchant_data: deposit
order_desc: order
phone: 20759**8347
purpose: Wallet / CASH
redirect_url: https://test.com/profile/refill
server_callback_url: https://test.com/payment/v1/287e42ec-fa99-4063-b995-7c113755ed21/callback_with_identity_common
zip_code: 24737Payout (Fawry)-CASH only
POST https://gate.centiwise.com/paynet/api/v4/payout/EndpointID
Parameters: 15
account_name: hussein sheib
account_number: 20**0999
amount: 262900.00
client_orderid: 1335731814
currency: EGP
ipaddress: 136.158.50.100
order_desc: order_1792780573
purpose: CASH
receiver_country_code: EG
receiver_email: [email protected]
receiver_first_name: Hussein
receiver_last_name: Sheib
receiver_phone: 20**0999
redirect_url: https://test.com/api/apm/response/CentiwiseAPM/QjFNZ05lZUZXWlhldjN5akVHSG9oUT09
server_callback_url: https://test.com/api/apm/response/CentiwiseAPM/QjFNZ05lZUZXWlhldjN5akVHSG9oUT09South Africa
South Africa does use apurposefield in BOTH Payin AND Payout.ABSA
Bidvest Bank Gro
FNB
Investec
TymeBank
Payin
POST https://gate.centiwise.com/paynet/api/v2/sale-form/EndpointID
or
POST https://gate.centiwise.com/paynet/api/v2/sale/EndpointID
Parameters: 18
address1: 201 Trent Pines 24737 North Cecilyside West Virginia KR
amount: 50.00
city: North Cecilyside
client_orderid: f1727c7b-5fb9-4a29-b388-15549f852072
control: df06269ed872217082f41004a7c1ea55e7f60b2c
country: SA
currency: ZAR
email: [email protected]
first_name: Doreen
ipaddress: 36.0.38.223
last_name: Wekesa
merchant_data: deposit
order_desc: order
phone: 2759**8347
purpose: ABSA
redirect_url: https://test.com/profile/refill
server_callback_url: https://test.com/payment/v1/287e42ec-fa99-4063-b995-7c113755ed21/callback_with_identity_common
zip_code: 24737| Bank | Bank Code |
|---|---|
| ABSA | 632005 |
| African Bank | 430000 |
| Bidvest Bank Gro | 462005 |
| FNB | 250655 |
| Investec | 580105 |
| Nedbank | 198765 |
| Standard Bank | 051001 |
| Tymebank | 678910 |
Payout
POST https://gate.centiwise.com/paynet/api/v4/payout/EndpointID
Parameters: 15
account_number: 6272xxx5124
amount: 163.59
bank_code: 250655
bank_name: FNB
client_orderid: 46015305
currency: ZAR
ipaddress: 105.247.36.243
order_desc: Withdrawal 46015305
purpose: FNB
receiver_country_code: ZA
receiver_email: [email protected]
receiver_first_name: NOMTHANDAZO DELOROUS
receiver_last_name: DIKUTLE
receiver_phone: 2762xxxx851
server_callback_url: https://test.com.callback/46015305/NrN7dVQWXOF Zone (Burkina Faso, Côte d'Ivoire, Senegal, Gabon, Benin)
Payin (Orange Money) — example using Côte d'Ivoire
POST https://gate.centiwise.com/paynet/api/v2/sale-form/EndpointID
or
POST https://gate.centiwise.com/paynet/api/v2/sale/EndpointID
Parameters: 18
address1: 201 Trent Pines 24737 North Cecilyside West Virginia KR
amount: 50.00
city: North Cecilyside
client_orderid: f1727c7b-5fb9-4a29-b388-15549f852072
control: df06269ed872217082f41004a7c1ea55e7f60b2c
country: CI
currency: XOF
email: [email protected]
first_name: Doreen
ipaddress: 36.0.38.223
last_name: Wekesa
merchant_data: deposit
order_desc: order
phone: 229759**8347
purpose: MTN or ORANGE
redirect_url: https://test.com/profile/refill
server_callback_url: https://test.com/payment/v1/287e42ec-fa99-4063-b995-7c113755ed21/callback_with_identity_common
zip_code: 24737Replace
"country": "CI"withBF,SN,GN, orBNfor other XOF countries. Keep"currency": "XOF"and"purpose": "ORANGE"or "MOOV" (As hightlighted on the above table).
Payout XOF
POST https://gate.centiwise.com/paynet/api/v4/payout/EndpointID
Parameters: 15
account_name: hussein sheib
account_number: 2290**0999
amount: 262900.00
client_orderid: 1335731814
currency: XOF
ipaddress: 136.158.50.100
order_desc: order_1792780573
purpose: MTN, ORANGE
receiver_country_code: CI
receiver_email: [email protected]
receiver_first_name: Hussein
receiver_last_name: Sheib
receiver_phone: 2290**0999
redirect_url: https://test.com/api/apm/response/CentiwiseAPM/QjFNZ05lZUZXWlhldjN5akVHSG9oUT09
server_callback_url: https://test.com/api/apm/response/CentiwiseAPM/QjFNZ05lZUZXWlhldjN5akVHSG9oUT09Updated 11 days ago
Did this page help you?
