Skip to main content

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.