A VTU API is an interface that lets software buy virtual top-ups — airtime, data bundles and bill payments — programmatically, instead of a person buying them by hand. Your application sends an authenticated request; the API delivers the top-up to the recipient and returns the result.
What “VTU” means
VTU stands for Virtual Top-Up. It is the electronic alternative to a physical recharge card: credit is loaded straight onto a phone number, meter or account over the network. A VTU platform resells those top-ups; a VTU API turns that platform into something your own code can call.
What a VTU API can do
In Nigeria, a capable VTU API covers the everyday recharges a business resells:
- Airtime on MTN, Glo, Airtel and 9mobile — sent by network, phone number and amount.
- Data bundles on every network — bought by plan code rather than free-form amount.
- Electricity for prepaid and postpaid meters — with the recharge token returned for prepaid.
- Cable TV (DSTV, GOtv, StarTimes), education PINs (WAEC, NECO, JAMB) and broadband (Smile, Spectranet).
How a VTU API works
The mechanics are consistent across good providers. You authenticate with a secret API key, fund a balance you draw down from, and make one call per purchase:
- Authentication. Each request carries a Bearer API key that identifies your business.
- A prepaid wallet. You fund a balance up front; every purchase debits it, so there is no card charge per transaction and your spend is capped by what you have funded.
- Idempotency. You attach a unique reference to each request so that a retry after a timeout never buys twice — critical when real money moves.
- Asynchronous truth. Most calls settle instantly, but some go Pending and resolve a little later. A reliable API reconciles automatically and refunds you if a purchase ultimately fails, and fires a webhook when the transaction reaches its final state.
What to look for in a Nigerian VTU API
Reselling is a thin-margin, high-volume business, so reliability and correctness matter more than a long feature list. Weigh providers on:
- Coverage — all four networks and the bill types you sell, behind one integration.
- Idempotency and auto-refunds — so retries are safe and failed deliveries return your money to the kobo, not your support inbox.
- Money in kobo — integer minor units (₦1 = 100 kobo) avoid floating-point rounding bugs.
- Funding that fits — for example a dedicated bank account number that auto-credits your wallet on transfer.
- Volume pricing you can see — the price you actually pay per plan, queryable before you buy.
Rule of thumb: if you cannot safely retry a call and trust the refund, the API is not production-ready for money movement — no matter how many networks it lists.
Where Plustive fits
Plustive is a B2B VTU and bill-payment API for Nigeria. One REST API and one prepaid wallet cover data and airtime across all four networks plus electricity, cable TV, education and broadband. Every purchase is idempotent on a clientReference, all money is in kobo, ambiguous calls reconcile in about a minute, and webhooks fire on the terminal state. See the guide to building a VTU app for the end-to-end flow.