Skip to main content
POST
/
validateSmartcard
Validate Cable TV
curl --request POST \
  --url https://api.bleeprs.com/api/validateSmartcard \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "smartcard": "8093245829",
  "provider": "DSTV"
}
'
{
  "gatewayStatus": "00",
  "gatewayMessage": "Successfully Processed",
  "requestReference": "bpr_req_a1b2c3d4e5f6",
  "data": {
    "name": "JANE DOE",
    "customerNumber": "123456789"
  }
}

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.

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