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/{biller_id}/packages3. Fetch Data & TV Packages
Retrieve real-time packages, data bundle variation codes, prices, and validity periods.
Request Headers
Header
Value
Authorization
Bearer cbi_live_xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type
application/json
X-Channel
api
Query Parameters
Parameter
Type
Description
biller_id*
string
Biller ID or slug (e.g. mtn-data, dstv)
Code Execution Playground
Request Snippet (CURL)
curl -X GET "https://backend.cbivas.com/api/v1/services/billers/mtn-data/packages" \ -H "Authorization: Bearer cbi_live_xxxxxxxxxxxxxxxxxxxxxxxx"
Success Response (200 OK)
[
{
"plan_code": "mtn-1gb-300",
"name": "MTN 1GB Daily",
"amount": "300.00",
"validity": "1 Day"
},
{
"plan_code": "mtn-10gb-3000",
"name": "MTN 10GB Monthly",
"amount": "3000.00",
"validity": "30 Days"
}
]