Skip to Content
Cable TV

Cable TV

Pay DStv, GOtv, and StarTimes subscriptions. Use product CABLE, put the smartcard / IUC number in customer_msisdn, and send a catalog plan_code.

POST /ext/breeze/v1/transactions

External create is async — poll Check status with your client_request_id.

1. List cable plans

GET /ext/breeze/v1/plans/bills/cable

Optional filter: ?network=DSTV.

curl "https://staging-intelligent-70287b6a3284.herokuapp.com/ext/breeze/v1/plans/bills/cable?network=DSTV" \
  -H "X-Merchant-Key: mk_live_your_key_id" \
  -H "X-Merchant-Secret: sk_live_your_secret"

Sample response:

{
  "status": "2000",
  "description": "Operation Successful-BILLS-CABLE",
  "data": [
    {
      "id": 3001,
      "name": "DStv Padi",
      "network": "DSTV",
      "product": "CABLE",
      "amount_type": "fixed",
      "price": "2950"
    }
  ]
}

Use plan id as plan_code. For fixed bouquets, amount should match the plan price.

Cable network values

DSTV, GOTV, STARTIMES

2. Pay cable TV

curl -X POST "https://staging-intelligent-70287b6a3284.herokuapp.com/ext/breeze/v1/transactions" \
  -H "Content-Type: application/json" \
  -H "X-Merchant-Key: mk_live_your_key_id" \
  -H "X-Merchant-Secret: sk_live_your_secret" \
  -d '{
    "merchant_code": "YOUR_MERCHANT",
    "customer_msisdn": "1234567890",
    "network": "DSTV",
    "product": "CABLE",
    "plan_code": "3015",
    "amount": "10500",
    "client_request_id": "breeze-cable-dstv-001"
  }'
FieldRequiredDescription
merchant_codeYesYour merchant profile
customer_msisdnYesSmartcard / IUC number
networkYesDSTV, GOTV, or STARTIMES
productYesCABLE
plan_codeYesCatalog id from plans list
amountYesPayment amount in Naira (string)
client_request_idYesUnique idempotency key

3. Check status

GET /ext/breeze/v1/transactions/status/{client_request_id}

See Transactions — Check status.

Ask your account manager to enable cable TV on your merchant profile before go-live.

Last updated on
ElectricityBetting