Plustiveplustive
Sign inGet API key

Data API

Airtel Data API

Buy and resell Airtel data bundles programmatically in Nigeria with one REST API and a prepaid wallet. Idempotent calls, instant delivery, automatic refunds.

Deliver Airtel data bundles programmatically from your app or platform with the Plustive data API and a prepaid wallet you fund once.

Airtel plans sit in the same catalog as MTN, Glo and 9mobile, so your code path is identical across all four networks.

Funding is a prepaid wallet you top up by bank transfer to a dedicated account, and every purchase draws it down — there’s no per-transaction card charge. Amounts are in integer kobo, so values stay exact.

The API call

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

curl -X POST https://api.plustiveimpact.com/api/v1/data \
  -H "Authorization: Bearer pk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "plan": "airtel-1-5gb-30d", "phone": "08030000000", "clientReference": "ord_8812" }'

→ { "reference": "PLS-9KQ2M7P", "status": "Success" }

What you get

  • Airtel data bundles on demand, bought by plan ID through one endpoint.
  • Idempotent on your clientReference — retries after a timeout never double-charge.
  • Instant delivery for most calls; ambiguous ones reconcile in ~1 minute and auto-refund on failure.
  • One prepaid wallet and one Bearer key across MTN, Glo, Airtel and 9mobile.
FAQ

Airtel Data API — FAQ

How do I sell Airtel data through an API?

List the available Airtel plans from the Plustive catalog to get each plan ID and the price you pay, then POST to /api/v1/data with the plan ID, the customer's phone number, and a unique clientReference. Plustive debits your prepaid wallet, delivers the bundle to the Airtel line, and returns the transaction status. The call is idempotent, so retries never double-charge.

Are Airtel data bundles delivered instantly?

Most Airtel data purchases settle instantly and return Success. If a response is ambiguous it returns Pending and reconciles automatically — usually within about a minute — and any failure is refunded to your wallet to the kobo, so you are never left paying for an undelivered bundle.

Do I need a separate integration for Airtel?

No. Plustive exposes MTN, Glo, Airtel and 9mobile data through the same endpoint and one prepaid wallet, so adding or switching networks is a change of plan ID — not a new integration.

Related: