Skip to main content
The Airtime API returns numeric codes to indicate transaction status and errors.

Transaction status codes


Common scenarios

The airtime was successfully delivered to the recipient. You will receive this code in callbacks and transaction status responses when the transfer completes.
Your account does not have enough credit to complete the transfer. Top up your balance before retrying.
The dest_addr value is not a valid mobile number in international format. Ensure the number includes the country code with no leading +.
The transfer is still being processed. Poll Transaction status or wait for a Callback.
Your API Key or Secret is incorrect. Regenerate credentials from Airtime → API Setup if needed.

HTTP status codes