TopupNaija Developer Hub
Connect your app to TopupNaija's utility vending services for airtime, data, electricity tokens, TV subscriptions, and PIN delivery.
Interactive OpenAPI Reference
Explore our fully interactive API sandbox. Test vending endpoints, verify live payload schemas, simulate response codes, and download code SDKs natively.
Go to Full API DocumentationAuthentication & Base Endpoint
All API requests must be routed securely through HTTPS using bearer header credentials generated inside your reseller dashboard.
Base URL: https://api.topupnaija.ng/v2
Header: Authorization: Bearer <YOUR_API_SECRET_KEY>
Core Vending Endpoints
Our streamlined API exposes lightweight REST JSON endpoints to trigger immediate digital recharges:
| Method | Route Endpoint | Function |
|---|---|---|
| POST | /vending/data | Purchase cheap mobile data bundles |
| POST | /vending/electricity | Generate prepaid DisCo electricity tokens |
| POST | /vending/airtime | Trigger instant cellular line recharges |
| POST | /vending/tv | Settle GOtv, DSTV & StarTimes renews |
| GET | /vending/status/{ref} | Check transaction status by reference |