Skip to content
English
Customer portal
Go to reloadly.com
  • There are no suggestions because the search field is empty.

Troubleshooting Failed Airtime Transactions

What should you do when an airtime transaction fails?

A failed airtime transaction is often related to one of two situations: the operator route is temporarily down, or the recipient number is not being accepted by the destination operator. In some cases, a top-up can be processed successfully even when the recipient has not yet seen the balance update, and the operator reference can be used to trace it.

Why can airtime top-ups fail?

Could the operator route be unavailable?

Yes. One reported cause is route downtime at the operator level, which can cause airtime top-ups to be declined. In that case, the route is restored with the operator, and transactions can be retried once service is back online.

Could the recipient number be invalid for the selected operator?

Yes. The error INVALID_RECIPIENT_PHONE usually indicates that the phone number used for the recharge is incorrect or does not match the selected operator. In markets with number portability, the number may belong to a different operator than expected.

What should you check first?

  1. Verify the recipient phone number.
  2. Confirm the selected operator matches the recipient number.
  3. If the market allows portability, confirm the number is still on the expected network.
  4. If the transaction was marked successful but no balance appears on the recipient side, use the confirmation reference to trace the top-up with the operator.

What if the transaction was processed successfully but the balance is still missing?

If the top-up was confirmed as processed successfully, provide the confirmation reference to the recipient’s mobile operator so they can trace the credit. In one documented case, the operator asked the customer to contact the carrier directly with the reference for investigation.

What if many failures are happening at once?

If multiple airtime transactions are failing with the same response, check whether the issue is limited to a specific operator route or country. Route-level downtime can affect a group of transactions and may resolve once the operator restores service.

What error examples are associated with failed airtime transactions?

  • TRANSACTION_CANNOT_BE_PROCESSED_AT_THE_MOMENT
  • INVALID_RECIPIENT_PHONE

Summary

To troubleshoot failed airtime transactions, first confirm the recipient number and operator, then check whether the issue is due to route downtime or a number portability mismatch. If a top-up was processed successfully but the balance is not visible, use the operator reference to trace the credit.