Plustiveplustive
Sign inGet API key

Airtime API

MTN Airtime API

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

Top up MTN lines programmatically with the Plustive airtime API. MTN is Nigeria's largest network, so it typically accounts for the highest share of airtime volume on any reseller platform.

Airtime is a free-amount product: you pass the value in kobo and Plustive delivers it to the MTN line. There are no fixed denominations to manage, so your product can offer flexible top-ups from a single API call.

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": "mtn", "amount": 50000, "phone": "08030000000", "clientReference": "air_5521" }'
  # amount 50000 = ₦500.00

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

What you get

  • MTN 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

MTN Airtime API — FAQ

How do I top up a MTN number via API?

POST to /api/v1/airtime with "network": "mtn", the recipient phone number, the amount in kobo, and a unique clientReference. Plustive debits your prepaid wallet and credits the MTN 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 MTN airtime?

Airtime is a free-amount product: pass any integer value in kobo, and that exact amount is delivered to the MTN 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 MTN 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: