Plustiveplustive
Sign inGet API key

Airtime API

Airtel Airtime API

Top up and resell Airtel airtime in Nigeria via one REST API and prepaid wallet. Integer kobo, idempotent calls, instant top-ups, auto-refunds.

Deliver Airtel airtime from your app or platform with a single authenticated POST. Airtel's national reach makes it a core network for any airtime reseller targeting the full Nigerian market.

Airtel airtime sits in the same request shape as every other network: "network": "airtel", amount in kobo, recipient phone, and your clientReference. No per-network setup needed.

Your wallet is funded by bank transfer to a dedicated account number (NUBAN) that credits automatically, so you never need to supply card details per transaction. All amounts are in integer kobo, keeping values exact with no floating-point rounding.

The API call

One authenticated POST /api/v1/airtime request, idempotent on your clientReference, with all money in integer kobo:

curl -X POST https://api.plustiveimpact.com/api/v1/airtime \
  -H "Authorization: Bearer pk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "network": "airtel", "amount": 50000, "phone": "08030000000", "clientReference": "air_5521" }'
  # amount 50000 = ₦500.00

→ { "reference": "PLS-7TQ1A2", "status": "Success" }

What you get

  • Airtel airtime delivered on demand with no fixed-denomination constraints.
  • Amount is integer kobo (₦500 = 50000) — no rounding, exact to the kobo.
  • Idempotent on clientReference — retrying after a timeout returns the original result, not a second charge.
  • One prepaid wallet and one Bearer key covers MTN, Glo, Airtel and 9mobile.
FAQ

Airtel Airtime API — FAQ

How do I top up a Airtel number via API?

POST to /api/v1/airtime with "network": "airtel", the recipient phone number, the amount in kobo, and a unique clientReference. Plustive debits your prepaid wallet and credits the Airtel line, returning the transaction reference and a Success or Pending status. Pending calls reconcile automatically — usually within a minute — and any failure refunds to your wallet.

What denomination can I send as Airtel airtime?

Airtime is a free-amount product: pass any integer value in kobo, and that exact amount is delivered to the Airtel line. There is no fixed-denomination restriction, so you can power flexible reseller flows or split large top-ups however your product needs.

Is a separate integration needed for Airtel vs other networks?

No. MTN, Glo, Airtel and 9mobile airtime all go through the same /api/v1/airtime endpoint with the same prepaid wallet. Switching networks is a change of the "network" field — not a new integration or a new set of credentials.

Related: