Core VAS
Bill Payments & Digital VAS
Disburse Airtime, Internet Data bundles, Electricity meter tokens, Cable TV subscriptions, and Education exam registration PINs (WAEC, JAMB, NECO) with sub-second fulfillment.
Architecture & Integration Guidelines:
- Workflow: 1. Get Categories -> 2. Get Billers -> 3. Fetch Packages -> 4. Verify Customer -> 5. Purchase with PIN & Idempotency Key.
- Automated Refunds: If a transaction fails, the system automatically rolls back and refunds your wallet immediately.
- Tokens & PINs: Electricity prepaid tokens and WAEC/JAMB PINs are returned immediately in the purchase response.
GET
/api/v1/services/categories1. List Service Categories
Retrieve all available utility service categories.
Request Headers
Header
Value
Authorization
Bearer cbi_live_xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type
application/json
X-Channel
api
Code Execution Playground
Request Snippet (CURL)
curl -X GET "https://backend.cbivas.com/api/v1/services/categories" \ -H "Authorization: Bearer cbi_live_xxxxxxxxxxxxxxxxxxxxxxxx"
Success Response (200 OK)
[
{
"id": "cat_1",
"name": "Airtime Recharge",
"slug": "airtime"
},
{
"id": "cat_2",
"name": "Data Services",
"slug": "data"
},
{
"id": "cat_3",
"name": "Electricity Bill",
"slug": "electricity"
},
{
"id": "cat_4",
"name": "Cable TV",
"slug": "cable"
},
{
"id": "cat_5",
"name": "Education",
"slug": "education"
}
]