Test Mobile Wallets
A single sandbox account is available per provider. The account credentials are used to simulate the customer during a push payment. The PIN is used to authorize the transaction, while the outcome of the transaction is selected in the merchant portal.| Provider | Test Account | Authorization PIN | Supported Results |
|---|---|---|---|
| Airtel Money | 221100000101 | 1234 | Success / Timeout / Failed Auth / Cancelled |
| TNM Mpamba | 231100000101 | 1234 | Success / Timeout / Failed Auth / Cancelled |
How to Simulate a Successful Push Payment
1
Log in to the merchant portal
Log in to the OneKhusa Portal using your sandbox merchant account.
2
Open Test Your Integration
Go to Test Your Integration and select Simulate Push Payment.
3
Create the simulated push
Use the Push Payment API to create the push payment. The new transaction appears in a Pending state, waiting for customer authorization.
4
Authorize the pending transaction
Open the pending transaction and select Authorize to simulate the customer approving the payment.Use the Authorization PIN provided for the test account to complete the simulated customer authorization.
5
Process the success webhook
OneKhusa dispatches the
pushpayment.success event to your callback URL. Verify the webhook signature before updating your payment status.How to Simulate a Failed Push Payment
1
Create the simulated push
Use the Push Payment API to create the push payment. The new transaction appears in a Pending state, waiting for customer authorization.
2
Choose a failure scenario
Open the pending transaction and select one of the failure scenarios available in the Simulate Push screen.
3
Process the failure webhook
OneKhusa dispatches the
pushpayment.failed event to your callback URL. Do not mark the order as paid when this event is received.