Cable TV Subscription API

Integrate DStv, GOtv, StarTimes and Showmax into your platform using a secure HTTPS GET API. Responses are returned in JSON.

GET HTTPS JSON

Your Credentials

UserID

APIKey

********************************

Generate New Key

Endpoints

Cable TV Subscription

APICableTVV1.asp

https://www.nellobytesystems.com/APICableTVV1.asp?UserID=your_userid&APIKey=your_apikey&CableTV=cabletv_code&Package=package_code&SmartCardNo=recipient_smartcardno&PhoneNo=recipient_phoneno&RequestID=request_id&CallBackURL=callback_url

Verify Smartcard / IUC

APIVerifyCableTVV1.asp

https://www.nellobytesystems.com/APIVerifyCableTVV1.asp?UserID=your_userid&APIKey=your_apikey&CableTV=cabletv_code&SmartCardNo=recipient_smartcardno

Query Transaction

By OrderID

https://www.nellobytesystems.com/APIQueryV1.asp?UserID=your_userid&APIKey=your_apikey&OrderID=order_id

By RequestID

https://www.nellobytesystems.com/APIQueryV1.asp?UserID=your_userid&APIKey=your_apikey&RequestID=request_id

Try It (Live Test)

Build a request URL and test quickly. (Uses browser fetch; CORS depends on server settings.)

UserID

APIKey

CableTV

Package

SmartCardNo / IUC

PhoneNo

RequestID

CallBackURL

Idle

Request URL

—

Response

—

Request Parameters

Parameter	Description
UserID	Your account UserID.
APIKey	Your API key used to authenticate requests.
CableTV	Cable TV code (see “Available Cable TV Types” below) Tip: Use Verify Smartcard endpoint before subscription to validate customer.
Package	Cable TV package code (see “Available Cable TV Packages” below)
SmartCardNo	Recipient smartcard/IUC number.
PhoneNo	Recipient phone number.
RequestID	Unique request ID (recommended for reconciliation).
CallBackURL	Callback URL for asynchronous transaction status updates.

Available Cable TV Types

You can fetch available networks in JSON using:
https://www.nellobytesystems.com/APICableTVTypeV2.asp?UserID=

Cable TV Name	Cable TV ID	Discount Amount	Discount (%)
DSTV	dstv	0.990	1.00%
GOTV	gotv	0.990	1.00%
STARTIMES	startimes	0.990	1.00%
SHOWMAX	showmax	0.995	0.50%

Available Cable TV Packages

You can fetch available packages in JSON using:
https://www.nellobytesystems.com/APICableTVPackagesV2.asp?UserID=

Cable TV Name	Cable TV ID
Package	Cable TV package code (see “Available Cable TV Packages” below) https://www.nellobytesystems.com/APICableTVPackagesV2.asp?UserID= DStv package codes Loading packages... GOtv package codes Packages will load when this tab opens. StarTimes package codes Packages will load when this tab opens. Showmax package codes Packages will load when this tab opens.

Examples

Sample: Buy DStv Padi

Use your own UserID / APIKey

https://www.nellobytesystems.com/APICableTVV1.asp?UserID=CK123&APIKey=456&CableTV=dstv&Package=dstvpadi&SmartCardNo=1234567890&PhoneNo=08149659347&CallBackURL=http://www.your-website.com

JSON response (order received)

{
  "orderid": "789",
  "statuscode": "100",
  "status": "ORDER_RECEIVED"
}

Verify smartcard (success / error)

APIVerifyCableTVV1.asp

https://www.nellobytesystems.com/APIVerifyCableTVV1.asp?UserID=CK123&APIKey=456&CableTV=dstv&SmartCardNo=1234567890

{ "customer_name": "BALOGUN SUNDAY LIV LADORITE" }

{ "customer_name": "INVALID_SMARTCARDNO" }

Callback (CallBackURL)

After processing, we will call your CallBackURL with the OrderID, StatusCode, OrderStatus, and OrderRemark.

Query string format

http://your_callback_url?orderdate=22th-Jul-2023&orderid=6501321715&statuscode=200&orderstatus=ORDER_COMPLETED&orderremark=TRANSACTION%20SUCCESSFUL

JSON format

{
  "orderdate": "22th-Jul-2023",
  "orderid": "6501321715",
  "requestid": "",
  "statuscode": "200",
  "orderstatus": "ORDER_COMPLETED",
  "orderremark": "TRANSACTION SUCCESSFUL"
}

Note: You can only cancel a transaction whose status is ORDER_RECEIVED or ORDER_ONHOLD.

Status Codes

Common errors and statuses are listed below. For the full list, use: View full list of Status Code and Descriptions

STATUS	DESCRIPTION
`INVALID_CREDENTIALS`	The UserID and API key combination is not correct.
`MISSING_CREDENTIALS`	The URL format is not valid.
`MISSING_USERID`	UserID field is empty.
`MISSING_APIKEY`	API Key field is empty.
`MISSING_CABLETV`	CableTV field is empty.
`MISSING_PACKAGE`	Package field is empty.
`INVALID_SMARTCARDNO`	An invalid smartcard number was entered.
`PACKAGE_NOT_AVAILABLE`	Selected package is not currently available.
`ORDER_RECEIVED`	Your order has been received.

Since we use a GET API, responses are returned in JSON.

Cable TV Subscription API

Latest Posts

Useful Links

Contact Us