Skip to main content
POST
Purchase Cable TV

Overview

Purchase a subscription package for a validated Cable TV smartcard. The subscription will be activated instantly.

Request Body

Response Fields

string
Reference to store for reconciliation, support, and requerying pending transactions.
string
Smartcard number for the completed purchase.
string
Cable TV provider for the completed purchase.
string
Purchased package name, when available.
number
Package amount, in Naira.
number
Commission earned on the purchase, in Naira.

Status Codes

Notes

  • Validate the smartcard before purchase and let the customer confirm the returned details.
  • Use the productCode from the cable TV catalog as bouquetCode.
  • Use the package amount returned by the catalog.
  • If the API returns gatewayStatus: "01" or an accepted pending response, wait at least 2 minutes before calling Requery Transaction.

Authorizations

Authorization
string
header
required

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

Body

application/json
amount
number
required

Package amount returned by the CableTVList endpoint

Example:

15700

smartcard
string
required

The validated customer smartcard or IUC number

Example:

"8093245829"

phone
string
required

The customer phone number

Example:

"08000000000"

provider
string
required

The Cable TV provider

Example:

"DSTV"

bouquetCode
string
required

Product code returned by the CableTVList endpoint

Example:

"DSTV_PACKAGE_CODE"

Response

Successfully Processed

gatewayStatus
string
Example:

"00"

gatewayMessage
string
Example:

"Successfully Processed"

requestReference
string
Example:

"bpr_req_a1b2c3d4e5f6"

data
object