Recharge PIN denominations
Bearer ds_live_ / ds_test_GET
/api/v1/merchant/recharge-pin/denominationsShows each denomination in stock for a network, how many PINs are available and what you pay per PIN.
Language
curl -X GET "https://finaldatasub.com/api/v1/merchant/recharge-pin/denominations?network=MTN" \
-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 · 400 Bad Request — Missing network
{
"network": "MTN",
"biller": "mtn-recharge-pin",
"denominations": [
{
"denomination": 100,
"available_count": 250,
"effective_amount": 98
},
{
"denomination": 200,
"available_count": 180,
"effective_amount": 196
},
{
"denomination": 500,
"available_count": 90,
"effective_amount": 490
}
]
}Errors
Errors specific to this endpoint, in addition to the authentication and validation errors common to every request.
| Code | HTTP | When |
|---|---|---|
| REQUIRED | 400 | None of biller, network or network_id was sent. |
| BILLER_NOT_FOUND | 404 | Unknown or inactive biller / network. |