Airtime
Search…
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.
Last modified 1mo ago
Export as PDF
Copy link