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/billers?category_slug={slug}2. List Billers & Providers
Fetch active service providers/billers under a given category.
Request Headers
Header
Value
Authorization
Bearer cbi_live_xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type
application/json
X-Channel
api
Query Parameters
Parameter
Type
Description
category_slug*
string
Category slug (airtime, data, electricity, cable, education)
Code Execution Playground
Request Snippet (CURL)
curl -X GET "https://backend.cbivas.com/api/v1/services/billers?category_slug=data" \ -H "Authorization: Bearer cbi_live_xxxxxxxxxxxxxxxxxxxxxxxx"
Success Response (200 OK)
[
{
"id": "bil_mtn_data",
"name": "MTN Data",
"slug": "mtn-data"
},
{
"id": "bil_airtel_data",
"name": "Airtel Data",
"slug": "airtel-data"
},
{
"id": "bil_ikedc",
"name": "Ikeja Electric - IKEDC",
"slug": "ikeja-electric"
},
{
"id": "bil_waec_pin",
"name": "WAEC Result Checker PIN",
"slug": "waec-result-checker"
}
]