Developers
TOPUPMATE DEVELOPER PORTAL

Build on Verified Bill Payment Infrastructure.

Access standardized REST APIs, sandbox testing environments, and comprehensive documentation to integrate airtime, data, electricity, TV, and digital services directly into your product.

🔒 Free registration required to generate sandbox keys and view full endpoint documentation.
GETTING STARTED

Three steps to start building

STEP 01

Register on Topupmate

Sign up in 60 seconds with your email and business name. No upfront commitments or credit card required.

STEP 02

Unlock Docs & Staging

Instantly unlock the full interactive documentation, test endpoints, generate sandbox keys, and simulate webhook events.

STEP 03

Switch to Production

Complete your business verification, fund your unified balance ledger, switch to live production API keys, and start processing.

INFRASTRUCTURE STANDARDS

Engineered for predictable integration.

RESTful Architecture

Standard HTTP methods, predictable resource-oriented URLs, and standard JSON response payloads.

Unified Balance Ledger

Fund one master wallet balance to power airtime, electricity, TV subscriptions, and vouchers simultaneously.

Real-Time Webhook Events

Receive automatic asynchronous HTTP callbacks with delivery statuses, token payloads, and transaction reference IDs.

Multi-Route Reliability

Automated routing across upstream providers to maintain consistent transaction success without duplicate debits.

API SCOPE

Supported API capabilities

All available via your single API bearer token upon account creation.

Airtime & Data Rails

POST /v1/airtime/topup POST /v1/data/bundles

Direct VTU, SME data, corporate gifting bundles, and balance query.

Electricity & Utility Tokens

POST /v1/electricity/validate POST /v1/electricity/vend

Meter customer name lookup, prepaid token generation, and postpaid bill settlement.

Cable TV Renewals

POST /v1/cable/validate POST /v1/cable/subscribe

Smartcard IUC lookup, package bouquet queries, and instant renewal.

Educational Exam PINs

POST /v1/education/pins

WAEC, JAMB, and NECO result checker PIN dispatch and batch generation.

Digital Vouchers & Rewards

POST /v1/vouchers/generate POST /v1/vouchers/redeem

Programmatic creation of branded digital codes and redemption validation.

Virtual Cards & Global Rails

POST /v1/cards/issue POST /v1/cards/fund

3D Secure card creation, wallet funding, and transaction monitoring.

Ready to explore the API and documentation?

Create your free developer account today to get your sandbox keys and view complete endpoint references.

CHOOSE YOUR PATH

How would you like to use Topupmate?

Select the option that best describes what you want to achieve today.

Not sure? Talk to our team →