Payment Error Codes

Payment-specific status codes returned in the response body for transaction endpoints (e.g., v2/topup). To simulate an error, send a request with the provided "Test Account" number corresponding to the desired error type. This allows you to test your application's error handling in the staging environment.

INFO

This Test Account Number should only be used in staging environment and NOT production.

The status code is returned in data.statusCode in the response body.

Retry Column

• Y — Transaction is not yet final. Resubmit the same request (with the same refid) to get the updated status.
• N — Transaction status is final. No retry needed.

Requests are idempotent via the refid field — you can safely retry without creating duplicate transactions.

Status Code	Status	Description	Retry	Test Account
0	Accepted	Transaction accepted and will be sent for processing	Y
1	Processing	Transaction is still being processed	Y
20	Succesful	Transaction is successful	N
40, 52	Failed	Invalid account number or mobile number (barred/terminated)	N	60123450052
41	Failed	Client's account has been suspended or an unauthorized access has occurred	N	60123450041
43	Failed	Insufficient credit on client's wallet	N	60123450043
44	Failed	Incorrect format or an invalid product has been passed	N	60123450044
45	Failed	Product out of stock	N	60123450045
47	Failed	Service currently unavailable. Try again later	N	60123450047
48	Failed	Transaction rejected by provider	N	60123450048
53	Refund	Triggered when user requests to void/refund a transaction	N
54	Failed	Duplicate transaction, or daily account transaction limit has been reached	N	60123450464
55	Failed	Transaction failed due to timeout	N	60123450055
56	Failed	Account blacklisted	N	60123450056
57	Failed	Customer's mobile number activated	N	60123450057
58, 61	Failed	Invalid denomination	N	60123450861