VTU

Airtime, data, cable TV, electricity, and exam pins

Buy airtime, data, cable TV subscriptions, electricity tokens, and exam pins directly via API. Every purchase debits your wallet first, then either confirms, is left processing (for providers that confirm asynchronously), or fails and is automatically refunded to your wallet.

VTU is enabled per-merchant. If it isn’t enabled on your account, these endpoints return a SERVICE_NOT_ENABLED error — contact support to request access.

Unlike other ABCMPay endpoints, VTU’s reference is generated by us, not sent by you — it comes back in the purchase response. Save it to poll Check VTU Transaction Status.

Buy Airtime

POST /api/v1/vtu/airtime

network · string · required

One of: mtn, glo, airtel, 9mobile.

phone · string · required

Recipient phone number.

amount · number · required

Amount in Naira (min ₦50, max ₦50,000).

airtime_type · string · default: "VTU"

VTU or Sharesell.

curl -X POST "https://www.abcmpay.com/api/v1/vtu/airtime" \
  -H "X-Api-Key: your-public-key" \
  -H "X-Api-Secret: your-secret-key" \
  -H "Content-Type: application/json" \
  -d '{
    "network": "mtn",
    "phone": "08012345678",
    "amount": 500
}'

Response

{
    "success": true,
    "status": "success",
    "message": "Transaction successful.",
    "reference": "VTU-AIR-20260215120000-K3F9QZ",
    "token": null
}

This same response shape (success, status, message, reference, token) is returned by every purchase endpoint below.

status	Meaning
success	Confirmed immediately
processing	Sent to the provider, confirming asynchronously — poll status or wait for it to settle
fail	Failed — wallet already refunded

---

Data

GET /api/v1/vtu/data-plans?network={network}

Returns available data plans, each with the id you pass as data_plan_id below. network is optional and filters the list.

POST /api/v1/vtu/data

phone · string · required

Recipient phone number.

data_plan_id · integer · required

Plan ID from Get Data Plans.

---

Cable TV

GET /api/v1/vtu/cable-plans?provider_name={provider}

Returns available cable plans (DSTV, GOTV, Startimes). provider_name is optional.

POST /api/v1/vtu/cable

cable_plan_id · integer · required

Plan ID from Get Cable Plans.

smart_card_number · string · required

Smart card / IUC number.

phone · string

Customer phone number.

---

Electricity

GET /api/v1/vtu/discos

Returns supported electricity providers (discos).

POST /api/v1/vtu/electricity

disco_id · integer · required

Disco ID from Get Discos.

meter_number · string · required

Meter number.

meter_type · string · required

Prepaid or Postpaid.

amount · number · required

Amount in Naira (min ₦500, max ₦100,000).

customer_name · string

customer_address · string

customer_phone · string

On success, token in the response carries the prepaid meter token — the only endpoint where that field is populated.

---

Exam Pins

GET /api/v1/vtu/exam-types

Returns supported exam types (WAEC, NECO, etc.), each with a selling_price.

POST /api/v1/vtu/exam

exam_type_id · integer · required

Exam type ID from Get Exam Types.

quantity · integer · required

Number of pins (1–20).

---

Check VTU Transaction Status

GET /api/v1/vtu/transaction/status?reference={reference}

Use the reference returned from any purchase endpoint above.

Response

{
    "success": true,
    "reference": "VTU-AIR-20260215120000-K3F9QZ",
    "type": "debit",
    "service": "airtime",
    "status": "Success",
    "amount": 500,
    "description": "VTU Airtime (mtn) to 08012345678",
    "date": "2026-02-15T12:00:00Z"
}