Skip to main content
POST
Validate Cable TV

Overview

Validate a Cable TV smartcard (e.g., DSTV, GOTV, Startimes) against the provider to ensure it belongs to a valid customer before proceeding with a subscription payment.

Request Body

Response Fields

string
Customer name returned for the smartcard.
string
Customer address returned for the smartcard, when available.
string
Customer type returned for the smartcard, when available.
number
Outstanding amount returned for the smartcard, when available.

Notes

  • Call Cable TV Bouquets first to get supported providers and packages.
  • Use the provider value from the catalog when validating the smartcard.
  • Show the returned customer details to the customer before purchase.

Authorizations

Authorization
string
header
required

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

Body

application/json
smartcard
string
required

The customer Cable TV smartcard or IUC number

Example:

"8093245829"

provider
string
required

The Cable TV provider (e.g. DSTV, GOTV, STARTIMES)

Example:

"DSTV"

Response

200 - application/json

Successfully Processed

gatewayStatus
string
Example:

"00"

gatewayMessage
string
Example:

"Successfully Processed"

requestReference
string
Example:

"bpr_req_a1b2c3d4e5f6"

data
object