Biller products
Bearer ds_live_ / ds_test_GET
/api/v1/merchant/billers/{slug}/productsReturns the active products (plans, bouquets, PIN types) of a single biller with your effective price for each.
Live product catalog
Prices depend on your account pricing group. Sign in to browse the billers and plans, and copy the slugs and plan ids you need for API requests.
Language
curl -X GET "https://finaldatasub.com/api/v1/merchant/billers/dstv/products" \
-H "Authorization: Bearer ds_live_YOUR_KEY" \
-H "Accept: application/json"Authentication
Send your secret API key in the header. Authorization: Token … and X-API-Key: … are also accepted.
| Header | Value | Required |
|---|---|---|
| Authorization | Bearer ds_live_YOUR_KEY | Yes |
| Accept | application/json | Recommended |
Authentication failures (401 UNAUTHORIZED, 403 IP_NOT_ALLOWED / ACCOUNT_SUSPENDED / API_ACCESS_NOT_APPROVED, 429 RATE_LIMITED) are listed in Authentication.
Parameters
Responses
200 OK — OK · 404 Not Found — Unknown biller
{
"biller_slug": "dstv",
"biller_name": "DStv",
"count": 1,
"data": [
{
"id": 640,
"name": "DStv Compact",
"code": "dstv-compact",
"description": "",
"size": null,
"plan_type": null,
"plan_type_slug": null,
"amount": 15700,
"currency": "NGN",
"validity_days": 30,
"is_variable_amount": false,
"min_amount": null,
"max_amount": null,
"sort_order": 2,
"is_special": false,
"msorg_plan_id": 640,
"adex_plan_id": 640,
"effective_amount": 15700,
"effective_fee": 0,
"effective_total": 15700,
"cashback": 0,
"benefit_type": null,
"benefit_label": ""
}
]
}Errors
Errors specific to this endpoint, in addition to the authentication and validation errors common to every request.
| Code | HTTP | When |
|---|---|---|
| BILLER_NOT_FOUND | 404 | No active biller with this slug, code or id. |