post
Vend cable
POST /api/v1/bills/cable
Authenticate with a bearer API key (rg_test_ in test mode, rg_live_ in live).
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Idempotency-Key | header | string | yes | |
wait | query | integer | no | Long-poll up to this many seconds for a final state; capped by the server |
Request
curl -X POST https://api.useroutegate.com/api/v1/bills/cable \
-H "Authorization: Bearer $ROUTEGATE_API_KEY" \
-H "Idempotency-Key: ord-00042-a1" \
-H "Content-Type: application/json" \
-d '{
"product_code": "mtn-sme-1gb",
"service_id": "<service_id>",
"serviceid": "<serviceid>",
"network": "mtn",
"biller": "<biller>",
"smartcard_number": "<smartcard_number>",
"account_number": "<account_number>",
"destination": "+2348012345678",
"phone_number": "<phone_number>",
"amount_kobo": 100000,
"amount": 0,
"client_reference": "ord-00042",
"metadata": {}
}'Response
202
{}
Error
402 Error envelope
{
"success": false,
"data": "<data>",
"message": "<message>",
"code": "<code>"
}Give this to your coding agent
Read https://useroutegate.com/docs/api/public/vendCable.md and implement this call. Keep one Idempotency-Key per attempt at the same order, treat 202 as accepted and resolve the final state from the webhook. Amounts are integers in kobo.