capabilities.work

Airtime Recharge

A 3-step recipe with Interswitch. We can help you get access.

Recipe · 3 steps

Airtime Recharge

List telcos, resolve a denomination, and top up a phone number.

  1. List the airtime billers under category 4 (MTN, Airtel, Glo, 9mobile).
  2. Read the supported denominations for the selected telco to confirm the paymentCode being charged.
  3. Submit the recharge advice. The recipient phone number is supplied as customerId per the airtime advice contract.
What you'll need to have ready
  • accessToken: Bearer access token from the Passport OAuth token endpoint.
  • billerId: The airtime telco biller id (under category 4).
  • paymentCode: The denomination payment code to charge (from the telco's payment items).
  • recipientPhone: Recipient mobile number in international format (sent as customerId).
  • customerEmail: Purchaser email for the receipt.
  • customerMobile: Purchaser mobile number.
  • amount: Recharge amount in minor currency units.
  • requestReference: Unique merchant request reference.
For your developer

Arazzo workflow interswitch:recharge-airtime, 3 operations: listAirtimeTelcos → listAirtimeDenominations → rechargeAirtime. Specs on APIs.io.