Get recharge PIN order
Bearer ds_live_ / ds_test_GET
/api/v1/merchant/recharge-pin/orders/{id}Returns one PIN order with the wallet balances around it and all of its PINs.
Language
curl -X GET "https://finaldatasub.com/api/v1/merchant/recharge-pin/orders/512" \
-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 — Not found
{
"success": true,
"id": 512,
"reference": "PIN-20261005-01",
"transaction_id": "DS261005104500T1U2V3W4",
"kind": "recharge",
"network": "MTN",
"biller": "mtn-recharge-pin",
"denomination": 100,
"selling_price": 98,
"quantity": 2,
"total_amount": 196,
"name_on_card": "Ada Stores",
"status": "successful",
"purchased_at": "2026-10-05T10:45:00+01:00",
"balance_before": 3531,
"balance_after": 3335,
"pins": [
{
"pin": "1234567890123456",
"serial": "SN00012345",
"load_code": "*311*PIN#"
},
{
"pin": "6543210987654321",
"serial": "SN00012346",
"load_code": "*311*PIN#"
}
]
}Errors
Errors specific to this endpoint, in addition to the authentication and validation errors common to every request.
| Code | HTTP | When |
|---|---|---|
| NOT_FOUND | 404 | No PIN order with this id on your account. |
Notes
- Amounts in PIN order responses are numbers, not two-decimal strings.