Testing our API

Only the phone numbers listed below work in sandbox. An arbitrary correctly-formatted number (e.g. a real number in valid international format) will not fall back to a generic success, it fails deterministically: deposits are marked failed, and payouts return "Test phone number was not found." (status_code: "000005"). Always pick a number from the tables below for the country, network, and scenario you want to simulate.

Test Funds

The funds available in the sandbox environment do not represent real money. You can top up your sandbox account in two ways.

Simulate a payin to your account using any of the provided test phone numbers below for the specific currency you would like to top up. (View available methods) You will then receive funds you can use to test payouts in the sandbox environment.
Request a manual deposit by contacting us through support@niobi.co

To use real money, switch to production environment using the steps outlined in Getting Started

Testing an OTP-verified flow (Côte d’Ivoire Orange)? Use 000000 as the OTP to simulate successful verification. See OTP-Verified Payins for the full two-step request flow.

Test Phone Numbers

Benin - MTN

Deposits

MSISDN	failureCode
22918314650	PAYER_NOT_FOUND
22918736651	PAYMENT_NOT_APPROVED
22918227652	OTHER_ERROR
22918047653	NO CALLBACK (stuck in SUBMITTED state)
22918580649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
22991666650	RECIPIENT_NOT_FOUND
22991117651	OTHER_ERROR
22991910652	NO CALLBACK (stuck in SUBMITTED state)
22991600649	N/A (COMPLETED)

Benin - MOOV

Deposits

MSISDN	failureCode
22928273651	PAYMENT_NOT_APPROVED
22928448652	OTHER_ERROR
22928937653	NO CALLBACK (stuck in SUBMITTED state)
22928070649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
22992194651	OTHER_ERROR
22992555652	NO CALLBACK (stuck in SUBMITTED state)
22992240649	N/A (COMPLETED)

Burkina Faso - Orange

Deposits

MSISDN	failureCode
22618736651	PAYMENT_NOT_APPROVED
22618227652	OTHER_ERROR
22618047653	NO CALLBACK (stuck in SUBMITTED state)
22618580649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
22691666650	RECIPIENT_NOT_FOUND
22691117651	OTHER_ERROR
22691910652	NO CALLBACK (stuck in SUBMITTED state)
22691600649	N/A (COMPLETED)

Burkina Faso - Moov

Deposits

MSISDN	failureCode
22628273651	PAYMENT_NOT_APPROVED
22628448652	OTHER_ERROR
22628937653	NO CALLBACK (stuck in SUBMITTED state)
22628070649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
22692194651	OTHER_ERROR
22692555652	NO CALLBACK (stuck in SUBMITTED state)
22692240649	N/A (COMPLETED)

Cameroon - MTN

Deposits

MSISDN	failureCode
237386548655	PAYER_LIMIT_REACHED
237384129650	PAYER_NOT_FOUND
237387073651	PAYMENT_NOT_APPROVED
237382469652	OTHER_ERROR
237389907653	NO CALLBACK (stuck in SUBMITTED state)
237387597649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
237919770650	RECIPIENT_NOT_FOUND
237931701651	OTHER_ERROR
237933875652	NO CALLBACK (stuck in SUBMITTED state)
237653456789	N/A (COMPLETED)

Cameroon - Orange

Deposits

MSISDN	failureCode
237487620655	PAYER_LIMIT_REACHED
237481077650	PAYER_NOT_FOUND
237487073651	PAYMENT_NOT_APPROVED
237481777654	INSUFFICIENT_BALANCE
237489899652	OTHER_ERROR
237481111653	NO CALLBACK (stuck in SUBMITTED state)
237487699649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
237750906089	RECIPIENT_NOT_ALLOWED_TO_RECEIVE
237791198119	OTHER_ERROR
237797788129	NO CALLBACK (stuck in SUBMITTED state)
237791189789	N/A (COMPLETED)

Côte d’Ivoire - MTN

Deposits

MSISDN	failureCode
2254807702650	PAYER_NOT_FOUND
2254897301651	PAYMENT_NOT_APPROVED
2254832397652	OTHER_ERROR
2254896488653	NO CALLBACK (stuck in SUBMITTED state)
2254805147649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
2259441955650	RECIPIENT_NOT_FOUND
2259453959651	OTHER_ERROR
2259429883652	NO CALLBACK (stuck in SUBMITTED state)
2259421131649	N/A (COMPLETED)

Côte d’Ivoire - Orange

Deposits

MSISDN	failureCode
2259445131650	OTHER_ERROR (FAILED)
2259445131649	N/A (COMPLETED)

OTP	failureCode
000000	Success
Any other code	Failed

Payouts

MSISDN	failureCode
2259885131650	OTHER_ERROR (FAILED)
2259885131649	N/A (COMPLETED)

Côte d’Ivoire - Moov

Deposits

MSISDN	failureCode
2254707702650	PAYER_NOT_FOUND
2254797301651	PAYMENT_NOT_APPROVED
2254732397652	OTHER_ERROR
2254796488653	NO CALLBACK (stuck in SUBMITTED state)
2254705147649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
2259451955650	RECIPIENT_NOT_FOUND
2259463959651	OTHER_ERROR
2259479883652	NO CALLBACK (stuck in SUBMITTED state)
2259481131649	N/A (COMPLETED)

Côte d’Ivoire - Wave

Deposits

MSISDN	failureCode
2254907702650	PAYER_NOT_FOUND
2254997301651	PAYMENT_NOT_APPROVED
2254932397652	OTHER_ERROR
2254996488653	NO CALLBACK (stuck in SUBMITTED state)
2254905147649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
2259875131650	OTHER_ERROR (FAILED)
2259875131649	N/A (COMPLETED)

Democratic Republic of the Congo - Vodacom

Deposits

MSISDN	failureCode
243585507655	PAYER_LIMIT_REACHED
243585804650	PAYER_NOT_FOUND
243586797651	PAYMENT_NOT_APPROVED
243758004654	INSUFFICIENT_BALANCE
243585236652	OTHER_ERROR
243585415653	NO CALLBACK (stuck in SUBMITTED state)
243589638649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
243950719650	RECIPIENT_NOT_FOUND
243956267651	OTHER_ERROR
243954539652	NO CALLBACK (stuck in SUBMITTED state)
243957311649	N/A (COMPLETED)

Democratic Republic of the Congo - Airtel

Deposits

MSISDN	failureCode
243689954652	OTHER_ERROR
243681458653	NO CALLBACK (stuck in SUBMITTED state)
243685892649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
243969884650	RECIPIENT_NOT_FOUND
243968354651	OTHER_ERROR
243962662652	NO CALLBACK (stuck in SUBMITTED state)
243960422649	N/A (COMPLETED)

Democratic Republic of the Congo - Orange

Deposits

MSISDN	failureCode
243781398650	PAYER_NOT_FOUND
243784186651	PAYMENT_NOT_APPROVED
243780100654	INSUFFICIENT_BALANCE
243783023652	OTHER_ERROR
243780678653	NO CALLBACK (stuck in SUBMITTED state)
243782087649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
243977582651	OTHER_ERROR
243978587652	NO CALLBACK (stuck in SUBMITTED state)
243971994649	N/A (COMPLETED)

Ghana - MTN

Deposits

MSISDN	failureCode
233593456019	PAYER_LIMIT_REACHED
233593456029	PAYER_NOT_FOUND
233593456039	PAYMENT_NOT_APPROVED
233593456069	OTHER_ERROR
233593456129	NO CALLBACK (stuck in SUBMITTED state)
233593456789	N/A (COMPLETED)

Payouts

MSISDN	failureCode
233593456089	RECIPIENT_NOT_FOUND
233593456119	OTHER_ERROR
233593456129	NO CALLBACK (stuck in SUBMITTED state)
233593456789	N/A (COMPLETED)

Ghana - AT

Deposits

MSISDN	failureCode
233273456069	OTHER_ERROR
233273456129	NO CALLBACK (stuck in SUBMITTED state)
233273456789	N/A (COMPLETED)

Payouts

MSISDN	failureCode
233273456089	RECIPIENT_NOT_FOUND
233273456099	RECIPIENT_NOT_ALLOWED_TO_RECEIVE
233273456119	OTHER_ERROR
233273456129	NO CALLBACK (stuck in SUBMITTED state)
233273456789	N/A (COMPLETED)

Ghana - Vodafone

Deposits

MSISDN	failureCode
233503456039	PAYMENT_NOT_APPROVED
233503456049	INSUFFICIENT_BALANCE
233503456069	OTHER_ERROR
233503456129	NO CALLBACK (stuck in SUBMITTED state)
233503456789	N/A (COMPLETED)

Payouts

MSISDN	failureCode
233503456089	RECIPIENT_NOT_FOUND
233503456099	RECIPIENT_NOT_ALLOWED_TO_RECEIVE
233503456119	OTHER_ERROR
233503456129	NO CALLBACK (stuck in SUBMITTED state)
233503456789	N/A (COMPLETED)

Kenya - Send Money

Deposits

MSISDN	failureCode
254168565652	OTHER_ERROR
254161166649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
254793260651	OTHER_ERROR
254647647649	N/A (COMPLETED)

Kenya - Airtel

Deposits

MSISDN	failureCode
254730000019	PAYER_LIMIT_REACHED
254730000029	PAYER_NOT_FOUND
254730000039	PAYMENT_NOT_APPROVED
254730000049	INSUFFICIENT_BALANCE
254730000069	OTHER_ERROR
254730000129	NO CALLBACK (stuck in SUBMITTED state)
254730000789	N/A (COMPLETED)

Payouts

MSISDN	failureCode
254731000089	RECIPIENT_NOT_FOUND
254731000099	RECIPIENT_NOT_ALLOWED_TO_RECEIVE
254731000119	OTHER_ERROR
254731000129	NO CALLBACK (stuck in SUBMITTED state)
254731000789	N/A (COMPLETED)

Kenya - PayBill

Payouts

Paybill Number	Account Number	failureCode
333806	00000000	OTHER_ERROR
333111	00000000	N/A (COMPLETED)

Kenya - Till Number

Payouts

MSISDN	failureCode
222641	OTHER_ERROR
222750	N/A (COMPLETED)

Kenya - Pesalink

Payouts

MSISDN	failureCode
123648951	OTHER_ERROR
123223837	N/A (COMPLETED)

Mali - Orange

Deposits

MSISDN	failureCode
22318314650	PAYER_NOT_FOUND
22318736651	PAYMENT_NOT_APPROVED
22318227652	OTHER_ERROR
22318047653	NO CALLBACK (stuck in SUBMITTED state)
22318580649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
22391666650	RECIPIENT_NOT_FOUND
22391117651	OTHER_ERROR
22391910652	NO CALLBACK (stuck in SUBMITTED state)
22391600649	N/A (COMPLETED)

Mali - Moov

Deposits

MSISDN	failureCode
22328273651	PAYMENT_NOT_APPROVED
22328448652	OTHER_ERROR
22328937653	NO CALLBACK (stuck in SUBMITTED state)
22328070649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
22392194651	OTHER_ERROR
22392555652	NO CALLBACK (stuck in SUBMITTED state)
22392240649	N/A (COMPLETED)

Nigeria - Bank

Virtual Account Deposits

MSISDN	failureCode
2349034567069	OTHER_ERROR
2349034567129	NO CALLBACK (stuck in SUBMITTED state)
2349034567899	N/A (COMPLETED)

Bank Payouts

MSISDN	failureCode
2349034567089	RECIPIENT_NOT_FOUND
2349034567119	RECIPIENT_NOT_ALLOWED_TO_RECEIVE
2349034567119	OTHER_ERROR
2349034567129	NO CALLBACK (stuck in SUBMITTED state)
2349034567899	N/A (COMPLETED)

Rwanda - Airtel

Deposits

MSISDN	failureCode
250733456039	OTHER_ERROR
250733456049	INSUFFICIENT_BALANCE
250733456069	OTHER_ERROR
250733456129	NO CALLBACK (stuck in SUBMITTED state)
250628503649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
250733456789	N/A (COMPLETED)
250733456089	RECIPIENT_NOT_FOUND
250733456119	OTHER_ERROR
250733456129	NO CALLBACK (stuck in SUBMITTED state)

Rwanda - MTN

Deposits

MSISDN	failureCode
250783456019	PAYMENT_NOT_APPROVED
250783456029	PAYER_NOT_FOUND
250783456039	PAYMENT_NOT_APPROVED
250783456069	OTHER_ERROR
250783456129	NO CALLBACK (stuck in SUBMITTED state)
250783456789	N/A (COMPLETED)

Payouts

MSISDN	failureCode
250783456089	RECIPIENT_NOT_FOUND
250783456099	RECIPIENT_NOT_ALLOWED_TO_RECEIVE
250783456119	OTHER_ERROR
250783456129	NO CALLBACK (stuck in SUBMITTED state)
250783456789	N/A (COMPLETED)

Senegal - Free

Deposits

MSISDN	failureCode
221896774654	INSUFFICIENT_BALANCE
221894186652	OTHER_ERROR
221891380653	NO CALLBACK (stuck in SUBMITTED state)
221896574649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
221879521651	OTHER_ERROR
221875331652	NO CALLBACK (stuck in SUBMITTED state)
221876621649	N/A (COMPLETED)

Senegal - Orange

Deposits

MSISDN	failureCode
221995330650	PAYER_NOT_FOUND
221995422654	INSUFFICIENT_BALANCE
221991304652	OTHER_ERROR
221994282653	NO CALLBACK (stuck in SUBMITTED state)
221994013649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
221886807651	OTHER_ERROR
221882382652	NO CALLBACK (stuck in SUBMITTED state)
221885338649	N/A (COMPLETED)

Senegal - Wave

Deposits

MSISDN	failureCode
221763456789	N/A (COMPLETED)

Payouts

MSISDN	failureCode
221763456119	FAILED
221763456789	N/A (COMPLETED)

Sierra Leone - Orange

Deposits

MSISDN	failureCode
23217231649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
23289137649	N/A (COMPLETED)

South Africa - Bank (EFT)

Deposits - Will return an authorization URL

MSISDN	failureCode
2763456789	N/A (COMPLETED)

Payouts

MSISDN	failureCode
2763456119	FAILED
2768856789	N/A (COMPLETED)

Tanzania - Airtel

Deposits

MSISDN	failureCode
255279442655	PAYER_LIMIT_REACHED
255277665650	PAYMENT_NOT_APPROVED
255276211654	INSUFFICIENT_BALANCE
255274069652	OTHER_ERROR
255271149653	NO CALLBACK (stuck in SUBMITTED state)
255273686649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
255718845650	RECIPIENT_NOT_FOUND
255715919651	OTHER_ERROR
255719870652	NO CALLBACK (stuck in SUBMITTED state)
255715543649	N/A (COMPLETED)

Tanzania - Vodacom

Deposits

MSISDN	failureCode
255377289651	PAYMENT_NOT_APPROVED
255370514654	OTHER_ERROR
255437106653	NO CALLBACK (stuck in SUBMITTED state)
25537982649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
255726632651	OTHER_ERROR
255727095652	NO CALLBACK (stuck in SUBMITTED state)
255720993649	N/A (COMPLETED)

Tanzania - Tigo

Deposits

MSISDN	failureCode
255471987651	PAYMENT_NOT_APPROVED
255478378654	INSUFFICIENT_BALANCE
255474578652	OTHER_ERROR
255475026653	NO CALLBACK (stuck in SUBMITTED state)
255470025649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
255732881650	RECIPIENT_NOT_FOUND
255731988653	RECIPIENT_NOT_ALLOWED_TO_RECEIVE
255731337651	OTHER_ERROR
255733402652	NO CALLBACK (stuck in SUBMITTED state)
255733666649	N/A (COMPLETED)

Tanzania - Halotel

Deposits

MSISDN	failureCode
255576307650	PAYER_NOT_FOUND
255578549654	INSUFFICIENT_BALANCE
255579799652	OTHER_ERROR
255578879653	NO CALLBACK (stuck in SUBMITTED state)
255571404649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
255746347650	RECIPIENT_NOT_FOUND
255742489651	OTHER_ERROR
255749503652	NO CALLBACK (stuck in SUBMITTED state)
255745383649	N/A (COMPLETED)

Togo - Moov

Deposits

MSISDN	failureCode
22818314650	PAYER_NOT_FOUND
22818736651	PAYMENT_NOT_APPROVED
22818227652	OTHER_ERROR
22818047653	NO CALLBACK (stuck in SUBMITTED state)
22818580649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
22891666650	RECIPIENT_NOT_FOUND
22891117651	OTHER_ERROR
22891910652	NO CALLBACK (stuck in SUBMITTED state)
22891600649	N/A (COMPLETED)

Togo - T-Money

Deposits

MSISDN	failureCode
22828273651	PAYMENT_NOT_APPROVED
22828448652	OTHER_ERROR
22828937653	NO CALLBACK (stuck in SUBMITTED state)
22828070649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
22892194651	OTHER_ERROR
22892555652	NO CALLBACK (stuck in SUBMITTED state)
22892240649	N/A (COMPLETED)

Uganda - Airtel

Deposits

MSISDN	failureCode
256889000655	PAYER_LIMIT_REACHED
256889000651	PAYMENT_NOT_APPROVED
256885490654	INSUFFICIENT_BALANCE
256888880652	OTHER_ERROR
256881222653	NO CALLBACK (stuck in SUBMITTED state)
256885490649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
256854433650	RECIPIENT_NOT_FOUND
256851123654	RECIPIENT_NOT_ALLOWED_TO_RECEIVE
256859765651	OTHER_ERROR
256851188653	NO CALLBACK (stuck in SUBMITTED state)
256851166649	N/A (COMPLETED)

Uganda - MTN

Deposits

MSISDN	failureCode
256671020655	PAYER_LIMIT_REACHED
256672062650	PAYER_NOT_FOUND
256678432652	OTHER_ERROR
256672753653	NO CALLBACK (stuck in SUBMITTED state)
256673005649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
256753347649	RECIPIENT_NOT_FOUND
256750902653	RECIPIENT_NOT_ALLOWED_TO_RECEIVE
256753764651	OTHER_ERROR
256753855649	N/A (COMPLETED)

Zambia - Airtel

Deposits

MSISDN	failureCode
260777250655	PAYER_LIMIT_REACHED
260773939651	PAYMENT_NOT_APPROVED
260772332654	INSUFFICIENT_BALANCE
260773220652	OTHER_ERROR
260774819653	NO CALLBACK (stuck in SUBMITTED state)
260776681649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
260760181650	RECIPIENT_NOT_FOUND
260765531651	OTHER_ERROR
260761455653	NO CALLBACK (stuck in SUBMITTED state)
260767822649	N/A (COMPLETED)

Zambia - MTN

Deposits

MSISDN	failureCode
260876630655	PAYER_LIMIT_REACHED
260875688650	PAYER_NOT_FOUND
260878136651	PAYMENT_NOT_APPROVED
260877139652	OTHER_ERROR
260874755653	NO CALLBACK (stuck in SUBMITTED state)
260873039649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
260779936650	RECIPIENT_NOT_FOUND
260778534651	OTHER_ERROR
260771119653	NO CALLBACK (stuck in SUBMITTED state)
260771312649	N/A (COMPLETED)

Zambia - Zamtel

Deposits

MSISDN	failureCode
260977140654	INSUFFICIENT_BALANCE
260971341652	OTHER_ERROR
260978918653	NO CALLBACK (stuck in SUBMITTED state)
260979482649	N/A (COMPLETED)

Payouts

MSISDN	failureCode
260781529651	OTHER_ERROR
260781453653	NO CALLBACK (stuck in SUBMITTED state)
260780796649	N/A (COMPLETED)

​Test Funds

​Test Phone Numbers

​Benin - MTN

​Deposits

​Payouts

​Benin - MOOV

​Deposits

​Payouts

​Burkina Faso - Orange

​Deposits

​Payouts

​Burkina Faso - Moov

​Deposits

​Payouts

​Cameroon - MTN

​Deposits

​Payouts

​Cameroon - Orange

​Deposits

​Payouts

​Côte d’Ivoire - MTN

​Deposits

​Payouts

​Côte d’Ivoire - Orange

​Deposits

​Payouts

​Côte d’Ivoire - Moov

​Deposits

​Payouts

​Côte d’Ivoire - Wave

​Deposits

​Payouts

​Democratic Republic of the Congo - Vodacom

​Deposits

​Payouts

​Democratic Republic of the Congo - Airtel

​Deposits

​Payouts

​Democratic Republic of the Congo - Orange

​Deposits

​Payouts

​Ghana - MTN

​Deposits

​Payouts

​Ghana - AT

​Deposits

​Payouts

​Ghana - Vodafone

​Deposits

​Payouts

​Kenya - Send Money

​Deposits

​Payouts

​Kenya - Airtel

​Deposits

​Payouts

​Kenya - PayBill

​Payouts

​Kenya - Till Number

​Payouts

​Kenya - Pesalink

​Payouts

​Mali - Orange

​Deposits

​Payouts

​Mali - Moov

​Deposits

​Payouts

​Nigeria - Bank

​Virtual Account Deposits

​Bank Payouts

​Rwanda - Airtel

​Deposits

​Payouts

​Rwanda - MTN

​Deposits

​Payouts

​Senegal - Free

​Deposits

​Payouts

Test Funds

Test Phone Numbers

Benin - MTN

Deposits

Payouts

Benin - MOOV

Deposits

Payouts

Burkina Faso - Orange

Deposits

Payouts

Burkina Faso - Moov

Deposits

Payouts

Cameroon - MTN

Deposits

Payouts

Cameroon - Orange

Deposits

Payouts

Côte d’Ivoire - MTN

Deposits

Payouts

Côte d’Ivoire - Orange

Deposits

Payouts

Côte d’Ivoire - Moov

Deposits

Payouts

Côte d’Ivoire - Wave

Deposits

Payouts

Democratic Republic of the Congo - Vodacom

Deposits

Payouts

Democratic Republic of the Congo - Airtel

Deposits

Payouts

Democratic Republic of the Congo - Orange

Deposits

Payouts

Ghana - MTN

Deposits

Payouts

Ghana - AT

Deposits

Payouts

Ghana - Vodafone

Deposits

Payouts

Kenya - Send Money

Deposits

Payouts

Kenya - Airtel

Deposits

Payouts

Kenya - PayBill

Payouts

Kenya - Till Number

Payouts

Kenya - Pesalink

Payouts

Mali - Orange

Deposits

Payouts

Mali - Moov

Deposits

Payouts

Nigeria - Bank

Virtual Account Deposits

Bank Payouts

Rwanda - Airtel

Deposits

Payouts

Rwanda - MTN

Deposits

Payouts

Senegal - Free

Deposits

Payouts