Welcome to RapidTopup API
The RapidTopup API lets you sell airtime, data, cable TV subscriptions, and electricity tokens directly from your own platform. If you run a fintech app, a reseller portal, or any business that handles utility payments in Nigeria, this is for you. You get a single REST API that covers airtime top-ups, data bundles, DSTV/GOtv/Startimes renewals, and prepaid/postpaid electricity across all major DISCOs — with a live environment and a full sandbox for testing before you go live.Getting Started
Quickstart Guide
Three steps to get your API key, test it, and make your first purchase call.
Authentication & Keys
How to authenticate requests with your live or test secret key.
Architecture & Best Practices
Critical patterns for avoiding double charges and sending funds to wrong accounts.
Webhooks & Callbacks
Get notified instantly when a transaction succeeds or fails — no polling needed.
Core API Reference
Get Wallet Balance
Check your available reseller balance in NGN in real-time before initiating transactions.
Get Data Plans
Fetch active data plans, pricing, and network IDs for MTN, Airtel, Glo, and 9mobile.
Verify Customer Account
Perform instant two-step account lookups for Cable TV smartcards and Electricity meters.
Execute Purchase
Programmatically purchase Airtime, Data, Cable TV renewals, and Electricity utility tokens.
Cable TV Subscriptions
Renew DSTV, GOTV, and Startimes subscriptions instantly.
Electricity Bill Payments
Vend prepaid and postpaid electricity tokens across all major DISCOs in Nigeria.
Run in Postman
One-click import: opens all B2B API endpoints, sample payloads, and response schemas directly inside your Postman app.

