> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rapidtopup.com.ng/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview & Introduction

> Official developer documentation for RapidTopup — high-performance automated VTU vending, cheap data bundles, cable TV renewals, and utility bill payments in Nigeria.

# 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

> [card] [Quickstart Guide](https://docs.rapidtopup.com.ng/getting-started.md)
>
> Three steps to get your API key, test it, and make your first purchase call.

> [card] [Authentication & Keys](https://docs.rapidtopup.com.ng/authentication.md)
>
> How to authenticate requests with your live or test secret key.

> [card] [Architecture & Best Practices](https://docs.rapidtopup.com.ng/architecture.md)
>
> Critical patterns for avoiding double charges and sending funds to wrong accounts.

> [card] [Webhooks & Callbacks](https://docs.rapidtopup.com.ng/webhooks.md)
>
> Get notified instantly when a transaction succeeds or fails — no polling needed.

***

## Core API Reference

> [card] [Get Wallet Balance](https://docs.rapidtopup.com.ng/api-reference/balance.md)
>
> Check your available reseller balance in NGN in real-time before initiating transactions.

> [card] [Get Data Plans](https://docs.rapidtopup.com.ng/api-reference/data.md)
>
> Fetch active data plans, pricing, and network IDs for MTN, Airtel, Glo, and 9mobile.

> [card] [Verify Customer Account](https://docs.rapidtopup.com.ng/api-reference/verify.md)
>
> Perform instant two-step account lookups for Cable TV smartcards and Electricity meters.

> [card] [Execute Purchase](https://docs.rapidtopup.com.ng/api-reference/purchase.md)
>
> Programmatically purchase Airtime, Data, Cable TV renewals, and Electricity utility tokens.

> [card] [Cable TV Subscriptions](https://docs.rapidtopup.com.ng/api-reference/cable.md)
>
> Renew DSTV, GOTV, and Startimes subscriptions instantly.

> [card] [Electricity Bill Payments](https://docs.rapidtopup.com.ng/api-reference/electricity.md)
>
> Vend prepaid and postpaid electricity tokens across all major DISCOs in Nigeria.

> [card] [Run in Postman](https://app.getpostman.com/run-collection/rapidtopup-b2b-api)
>
> One-click import: opens all B2B API endpoints, sample payloads, and response schemas directly inside your Postman app.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.