Skip to main content
POST
Buy Cable TV

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
reference
string
required

Your unique reference for this purchase, used for idempotency and tracking.

Maximum string length: 255
Example:

"bill_abc126"

service_code
string
required

A cable service code from List Billers (category=cable).

Example:

"dstv"

smartcard_number
string
required

The customer's smartcard or IUC number.

Maximum string length: 50
Example:

"1234567890"

bouquet_id
string
required

A bouquet ID from List Cable Bouquets for the same service_code.

Example:

"dstv-compact"

customer_name
string
required

The customer name returned by Smartcard Enquiry.

Maximum string length: 255
Example:

"John Doe"

Response

The purchase was accepted. Check data.status: successful, failed (refunded), or pending (settles later by webhook). The message is Bill payment successful, Bill payment failed or Bill payment is processing to match.

status
string
Example:

"success"

message
string
Example:

"Bill payment successful"

data
object