TopupNaija Developer Hub
Integrate Nigeria's most robust digital utility vending API directly into your applications. Fast routing, stable connections, and wholesale pricing.
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} | Query transaction/escrow routing states |
