Plustiveplustive
Sign inGet API key
LiveBill-payment API · live

Bill-payment API for Nigeria —
electricity, cable TV, education & broadband.

Pay electricity, cable TV, education and broadband bills over one REST API and one prepaid wallet. Verify the meter or smartcard holder, pay, and get the token or PIN back on the response — every call settles or refunds.

Get your API keyRead the docs
Products

One API, every top-up.

Data and airtime — plus four kinds of bills. One key, one prepaid wallet, one pattern: list → verify → pay.

Data

Bundles across MTN, Glo, Airtel & 9mobile, priced for your tier.

Airtime

Any amount, any network, delivered instantly.

New

Cable TV

DSTV, GOtv and StarTimes — confirm the smartcard holder, then pay.

New

Electricity

Prepaid & postpaid meters — the token comes back on the response.

New

Education

WAEC, NECO & JAMB result-checker PINs, vended on demand.

New

Broadband

Smile, Spectranet & more — renew a plan in one call.

The whole API

One pattern, every service.

Buy data, airtime and bills; verify a customer; query a transaction; list the catalog; check balance. All money is in kobo, one Bearer key.

Synchronous best-effort — most calls settle instantlyAmbiguous calls return Pending and reconcile in ~1 minclientReference makes every retry safe
POST/v1/electricity
# Pay an electricity bill — token returned
POST /v1/electricity
{
  "productId": "ikedc-prepaid",
  "meterNumber": "04123456789",
  "amount": 500000,  // kobo = ₦5,000
  "clientReference": "power_4001"
}

→ { "status": "Success", "token": "1234-5678-9012-3456" }
Why Plustive

Money-grade plumbing for airtime, data & bills.

Plustive owns the wallet, the ledger and the reconciliation so you don’t have to. You make one call; we make sure it’s correct.

One prepaid wallet

Fund once and draw down across every purchase. An append-only ledger records every debit, credit and refund to the kobo.

Predictable pricing

See your effective price per plan before you buy. Per-tier overrides on data, per-network discounts on airtime — no surprises.

Never double-charged

Idempotency on your clientReference means retries are safe. Exactly one debit, at most one refund — enforced at the database.

Self-healing transactions

If the supplier is slow, money is held and the transaction settles or refunds automatically. You always learn the final state.

Built for volume

Per-key rate limiting and concurrency-safe wallets keep throughput high without ever overspending your balance.

A REST API, nothing else

One REST surface: buy data, airtime and bills, verify a customer, query a transaction, list the catalog, check your balance. Bearer-key auth — that is the whole surface.

Reliability

You won’t double-charge a customer. Ever.

Plustive owns the wallet, the ledger and the reconciliation, so reselling airtime and data never means losing track of money. Every naira you move is accounted for — debited once, settled or refunded, and reconciled automatically.

Never double-charged

Idempotency on your clientReference makes every retry safe. Exactly one debit, at most one refund — enforced at the database, not in your code.

Always a final state

If the supplier is slow, the debit is held and the transaction settles or refunds on its own — usually within a minute. You always learn the outcome: Success, Failed or Refunded.

Automatic refunds

A failed or unfulfilled delivery returns to your wallet, to the kobo. No support tickets, no manual reconciliation, no money quietly lost.

Test it with real credit — on us.

We’ll credit your wallet with ₦1,000 to get you started — push real transactions and confirm your integration end-to-end before you fund it for production.

FAQ

Bill-payment API questions.

Which bills can I pay via the API?

Plustive pays four kinds of Nigerian bills over one REST API and one prepaid wallet: cable TV (DSTV, GOtv and StarTimes), electricity for prepaid and postpaid meters, education result-checker PINs (WAEC, NECO and JAMB), and broadband (including Smile and Spectranet). They all follow the same pattern: list the product, verify the customer where needed, then pay.

Do I get the electricity token back?

Yes. For a prepaid electricity meter the recharge token is returned in the token field of the purchase response, so you can show it to your customer immediately. You verify the meter holder first, then pay; electricity is variable-amount, so you pass the amount in kobo (minimum ₦100).

Which cable TV providers are supported?

Plustive supports DSTV, GOtv and StarTimes. You first verify the smartcard or IUC number to confirm the account holder, then pay the chosen bouquet in one call. Each payment is idempotent on your clientReference and settles or refunds automatically.

Can I buy WAEC/JAMB pins via API?

Yes. Education result-checker PINs for WAEC, NECO and JAMB are vended on demand through the API — no verification step is needed. The purchased PIN is returned in the token field of the response, and the call is idempotent on clientReference so retries never double-charge.

Per-service bill-payment guides:

Bills run on the same wallet as data and airtime. Review pricing across all services or jump into the developer docs to start paying bills.