Error Codes

Here is a comprehensive breakdown of all client and server-side errors that can occur during usage of the Airtime API.

Error Code	Description
COUNTRY_NOT_SUPPORTED	The specified country in the request is currently disabled or not supported.
OPERATOR_UNAVAILABLE_OR_ CURRENTLY INACTIVE	The specified operator is currently disabled or inactive on the platform.
COULD_NOT_AUTO_DETECT_OPERATOR	The mobile number's operator could not be auto-detected. This can be resolved by using the number lookup service
INVALID_AMOUNT_FOR_OPERATOR	The specified top-up amount is not valid for the given operator in the request.
TOKEN_EXPIRED	Access tokens have a finite lifetime which is indicated whenever they are issued. To track an access token's lifetime, you can either: Keep track of the expires_in value in the response gotten when a request is made for an access token. The value is expressed in seconds. Handle the HTTP 401 Unauthorized status code and the TOKEN_EXPIRED error code in the error response message. The API endpoint issues this status code when it detects an expired token.
INSUFFICIENT_BALANCE	The user's account balance is not sufficient enough to carry out their intended request.
MAX_DAILY_TRANSACTION_AMOUNT_ REACHED	The user's account has hit its maximum allowed transaction amount limit for the day. This can be increased by contacting support.
MAX_DAILY_TRANSACTION_COUNT_ REACHED	The user's account has hit its maximum allowed transaction count limit for the day. This can be increased by contacting support.
ACCOUNT_NOT_FOUND	The user's account does not exist. This can be resolved by contacting support.
INVALID_AMOUNT	The amount requested by the user is incorrect — either a wrong data type or an invalid amount specification (for operators with fixed ranges).
INVALID_RECIPIENT_PHONE	The specified recipientPhone parameter in the request is not valid for the specified country.
INVALID_SENDER_PHONE	The specified senderPhone parameter in the request is not valid for the specified country.
INVALID_PHONE_NUMBER	The specified phone number is not valid.
PHONE_RECENTLY_RECHARGED	A second recharge was attempted on a mobile number before the default waiting time of two minutes could elapse.
INACTIVE_ACCOUNT	The user's account has been deactivated due to suspicious activity. If you receive this message, do reach out to our support team.
TOPUP_TRANSACTION_FAILED	The attempt to carry out a function via the API is unsuccessful. If you receive this error, contact support for more details.
TRANSACTION_CANNOT_BE_PROCESSED_AT_THE_MOMENT	The attempt to carry out a function via the API is unsuccessful. If you receive this error, contact support for more details.
OPERATOR_NOT_IN_SERVICE	The specified operator in the request is currently disabled, inactive, or not in service on the platform.