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.
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"
  }'
const response = await fetch("https://tente.com.ng/api/v1/cable", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
    "Accept": "application/json"
  },
  body: JSON.stringify({
    serviceID: "gotv",
    billersCode: "2019482019",
    variation_code: "gotv-jolli",
    amount: 4850,
    phone: "08031234567",
    subscription_type: "renew",
    request_id: "REQ_CAB_" + Date.now()
  })
});

const result = await response.json();
console.log(result);
<?php

$client = new \GuzzleHttp\Client();

$response = $client->post('https://tente.com.ng/api/v1/cable', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_TOKEN',
        'Content-Type'  => 'application/json',
        'Accept'        => 'application/json',
    ],
    'json' => [
        'serviceID'         => 'gotv',
        'billersCode'       => '2019482019',
        'variation_code'    => 'gotv-jolli',
        'amount'            => 4850,
        'phone'             => '08031234567',
        'subscription_type' => 'renew',
        'request_id'        => 'REQ_CAB_' . uniqid(),
    ]
]);

$data = json_decode($response->getBody(), true);
print_r($data);
import requests

url = "https://tente.com.ng/api/v1/cable"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
    "Accept": "application/json"
}
payload = {
    "serviceID": "gotv",
    "billersCode": "2019482019",
    "variation_code": "gotv-jolli",
    "amount": 4850,
    "phone": "08031234567",
    "subscription_type": "renew",
    "request_id": "REQ_CAB_123456"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

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."
}