POST
/api/v1/cable
The Cable TV API provides two-step workflow for smartcard/IUC decoder verification and instant subscription renewal or package change across DSTV, GOTV, Startimes, and Showmax.
📺 Integrated Smartcard Validation
Pre-Payment Verification: Verify the decoder owner's name and current bouquet before debiting your wallet.
Support for Renew & Change: Choose between renewing the customer's current bouquet or upgrading/downgrading package.
Support for Renew & Change: Choose between renewing the customer's current bouquet or upgrading/downgrading package.
POST
/api/v1/cable-verify
Validate IUC or Smartcard numbers to look up the subscriber's registered name and account status.
Request Parameters (JSON Body)
| Parameter | Type | Required | Description |
|---|---|---|---|
serviceID |
string | Required | Provider identifier: dstv, gotv, startimes, showmax. |
billersCode |
string | Required | 10 to 11-digit Smartcard / IUC / UIC number (e.g. 2019482019). |
Sample Verification Response
{
"status": "success",
"message": "Smartcard verification successful",
"data": {
"Customer_Name": "MR. EMMANUEL OKONKWO",
"Status": "Active",
"Due_Date": "2026-09-30",
"Customer_Number": "2019482019",
"Customer_Type": "GOTV",
"Current_Bouquet": "GOtv Jolli",
"Renewal_Amount": 4850.00
}
}
GET
/api/v1/cable-variations
Retrieve bouquet packages and variation codes for any cable provider.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
service_id |
string | Optional | Filter by provider: dstv, gotv, startimes, showmax. |
Purchase Subscription Endpoint (POST)
| Parameter | Type | Required | Description & Example |
|---|---|---|---|
serviceID |
string | Required | Provider code: dstv, gotv, startimes, showmax. |
billersCode |
string | Required | Smartcard / IUC number (e.g., 2019482019). |
variation_code |
string | Required | Bouquet variation code (e.g., gotv-jolli, dstv-compact). |
amount |
numeric | Required | Bouquet price amount in Naira. |
phone |
string | Required | Customer's 11-digit notification phone number. |
subscription_type |
string | Required | renew (renew current bouquet) or change (switch to selected bouquet). |
request_id |
string | Optional | Unique merchant client tracking reference. |
Integration Code Examples
curl -X POST "https://tente.com.ng/api/v1/cable" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"serviceID": "gotv",
"billersCode": "2019482019",
"variation_code": "gotv-jolli",
"amount": 4850,
"phone": "08031234567",
"subscription_type": "renew",
"request_id": "REQ_CAB_9901"
}'
Sample 200 OK Success Response
{
"status": "success",
"message": "GOTV subscription of ₦4,850.00 to 2019482019 was successful.",
"data": {
"transaction_ref": "CAB2026083114251299AB",
"request_id": "REQ_CAB_9901",
"service_id": "gotv",
"provider_name": "GOTV Subscription",
"smartcard": "2019482019",
"variation_code": "gotv-jolli",
"subscription_type": "renew",
"amount": 4850.00,
"phone": "08031234567",
"type": "Cable TV Subscription",
"commission_rate": "1%",
"commission_earned": 48.50,
"new_balance": 42301.50,
"status": "completed",
"created_at": "2026-08-31T14:25:12+01:00"
}
}
Error Responses
400 Invalid Smartcard Number
{
"status": "error",
"message": "Unable to verify decoder / smartcard number."
}
402 Insufficient Balance
{
"status": "error",
"message": "Insufficient wallet balance."
}