Developers
Sell Airtime on Your Website
This page shows how to get your token, list networks and purchase airtime using the BillsHub Pay API.
API Base
https://primebytehub.com
BillsHub Endpoints
https://primebytehub.com/api/billshub/
Generate Token
https://primebytehub.com/api/billshub/auth/token/
List Networks
https://primebytehub.com/api/billshub/airtime/networks/
Purchase Airtime
https://primebytehub.com/api/billshub/airtime/purchase/
Receipt PDF
https://primebytehub.com/api/billshub/transactions/<kind>/<ref>/receipt/
Step 1
Generate Token
You must be logged in and approved for API access. Request below if not approved.
Authorization: Token
Keep your token secret. Use it only on your server.
Step 2
List Networks
Fetch available networks to show on your website.
GET https://primebytehub.com/api/billshub/airtime/networks/
Authorization: Token YOUR_TOKEN
No networks loaded.
Step 3
Purchase Airtime
Use token to purchase airtime.
POST https://primebytehub.com/api/billshub/airtime/purchase/
Authorization: Token YOUR_TOKEN
Content-Type: application/json
{"phone":"08012345678","network":"airtel","amount":"100.00"}
This is a real purchase endpoint. Only test with small amounts.
VTU Services
All VTU endpoints
These are the endpoints you use on your own website after generating a token.
Airtime
List networks
https://primebytehub.com/api/billshub/airtime/networks/
Purchase
https://primebytehub.com/api/billshub/airtime/purchase/
POST https://primebytehub.com/api/billshub/airtime/purchase/
Authorization: Token YOUR_TOKEN
{"phone":"08012345678","network":"mtn","amount":"100.00"}
Data
List networks
https://primebytehub.com/api/billshub/data/networks/
List plans
https://primebytehub.com/api/billshub/data/plans/
Purchase
https://primebytehub.com/api/billshub/data/purchase/
POST https://primebytehub.com/api/billshub/data/purchase/
Authorization: Token YOUR_TOKEN
{"phone":"08012345678","network":"mtn","plan_id":"MTN_1GB_30D","amount":"350.00"}
Cable TV
Providers
https://primebytehub.com/api/billshub/cable/providers/
Plans
https://primebytehub.com/api/billshub/cable/plans/
Validate
https://primebytehub.com/api/billshub/cable/validate/
Purchase
https://primebytehub.com/api/billshub/cable/purchase/
POST https://primebytehub.com/api/billshub/cable/purchase/
Authorization: Token YOUR_TOKEN
{"cable":"dstv","iuc":"1234567890","plan_id":"DSTV_COMPACT"}
Electricity
Discos
https://primebytehub.com/api/billshub/electricity/discos/
Validate
https://primebytehub.com/api/billshub/electricity/validate/
Purchase
https://primebytehub.com/api/billshub/electricity/purchase/
POST https://primebytehub.com/api/billshub/electricity/purchase/
Authorization: Token YOUR_TOKEN
{"disco":"ikeja_electric","meter_number":"12345678901","meter_type":"prepaid","amount":"1000.00","phone":"08012345678"}
Recharge Card
Networks
https://primebytehub.com/api/billshub/recharge-card/networks/
Denominations
https://primebytehub.com/api/billshub/recharge-card/denominations/
Print
https://primebytehub.com/api/billshub/recharge-card/print/
POST https://primebytehub.com/api/billshub/recharge-card/print/
Authorization: Token YOUR_TOKEN
{"network":"mtn","plan_type":"100","quantity":5,"card_name":"My Shop"}
Bulk SMS
Send
https://primebytehub.com/api/billshub/bulk-sms/send/
POST https://primebytehub.com/api/billshub/bulk-sms/send/
Authorization: Token YOUR_TOKEN
{"sender_id":"BillsHub","numbers":["08012345678"],"message":"Hello"}
API Plans
Request API access (Reseller)
Request access, then we enable your API after review.
Starter
Developer
For testing & small integrations.
Business
Reseller
For agents and daily airtime sales.
Enterprise
High Volume
Custom limits and support.