NuruPay Docs

Test numbers

Simulate every payment outcome in test mode.

In test mode, the last three digits of the phone number decide the outcome. Use any valid Tanzanian prefix (for example 0754123 + the suffix).

Phone ends inResultfailure_codeWebhook
any other (e.g. …789)succeeded—collection.succeeded
…001failedinsufficient_fundscollection.failed
…002failedcustomer_cancelledcollection.failed
…003failedcustomer_timeoutcollection.failed
…004succeeded, after an ambiguous network response—collection.succeeded
…006failed immediatelyinvalid_accountcollection.failed
…005network unavailable: stays created until it expires (30 min)customer_timeoutcollection.expired

Examples: 0754123789 succeeds, 0754123001 fails with insufficient funds, 0684123002 (Airtel) is cancelled by the customer.

Test mode runs the same code paths as live mode (validation, idempotency, fees, webhooks, balances), only the mobile-money network is simulated.