Skip to main content
Subscribe, renew, and manage cable TV subscriptions for DSTV, GOtv, Startimes, and other providers.

​
Get TV Providers

Retrieve the list of available cable TV providers. 
GET /api/v1/business/vas/cable-tv/fetch-providers
Signature required: Yes

​
Response

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "data": {
    "success": true,
    "billers": [
      {
        "type": "DSTV",
        "id": 1,
        "name": "DSTV",
        "narration": "Digital Satellite Television",
        "image": "https://..."
      },
      {
        "type": "GOTV",
        "id": 2,
        "name": "GOtv",
        "narration": "GOtv Nigeria",
        "image": "https://..."
      }
    ]
  }
}

​
Get Subscription Plans

Retrieve available subscription plans for a specific provider. 
GET /api/v1/business/vas/cable-tv/fetch-billers?type={providerType}
Signature required: Yes

​
Query parameters

ParameterTypeRequiredDescription
typestringYesProvider type (e.g., DSTV, GOTV)

​
Response

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "data": {
    "success": true,
    "plans": [
      {
        "id": 1,
        "type": "DSTV",
        "code": "DSTV_COMPACT",
        "name": "DStv Compact",
        "description": "DStv Compact Package",
        "price": "10500",
        "amount": "10500"
      }
    ]
  }
}

​
Validate Customer

Verify a customer’s smart card or IUC number before purchasing. 
POST /api/v1/business/vas/cable-tv/validate-customer
Signature required: Yes

​
Request body

FieldTypeRequiredDescription
billerIdstringYesProvider type (e.g., DSTV)
smartCardNostringYesCustomer’s smart card or IUC number

​
Request example

curl -X POST "https://api-dev.usenumero.com/numeroaccount/api/v1/business/vas/cable-tv/validate-customer" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key" \
  -H "x-signature-key: generated_signature" \
  -d '{
    "billerId": "DSTV",
    "smartCardNo": "1234567890"
  }'

​
Response

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "data": {
    "success": true,
    "status": "active",
    "message": "Customer validated",
    "customer": {
      "fullName": "John Doe",
      "biller": "DSTV",
      "iucNumber": "1234567890"
    }
  }
}

​
Purchase Subscription

Subscribe or renew a cable TV subscription. 
POST /api/v1/business/vas/cable-tv/purchase
Signature required: Yes

​
Request body

FieldTypeRequiredDescription
referencestringYesYour unique transaction reference
typestringYesProvider type (e.g., DSTV)
codestringYesPlan code (from subscription plans)
smartCardNostringYesCustomer’s smart card number
renewalbooleanNoWhether this is a renewal (default: true)
amountnumberYesPlan amount in Naira

​
Request example

curl -X POST "https://api-dev.usenumero.com/numeroaccount/api/v1/business/vas/cable-tv/purchase" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key" \
  -H "x-signature-key: generated_signature" \
  -d '{
    "reference": "TV-20240115-001",
    "type": "DSTV",
    "code": "DSTV_COMPACT",
    "smartCardNo": "1234567890",
    "renewal": true,
    "amount": 10500
  }'

​
Response

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "data": {
    "success": true,
    "status": "completed",
    "message": "Subscription successful",
    "reference": "TV-20240115-001"
  }
}

​
Get Add-on Packages

Retrieve available add-on packages for a subscription plan. 
GET /api/v1/business/vas/cable-tv/fetch-tv-add-ons?type={providerType}&code={planCode}
Signature required: Yes

​
Query parameters

ParameterTypeRequiredDescription
typestringYesProvider type
codestringYesPlan code

​
Response

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "data": {
    "success": true,
    "status": "ok",
    "message": "Add-ons retrieved",
    "data": [
      {
        "addOnProductCode": "HDPVR",
        "productCode": "DSTV_COMPACT",
        "name": "HD PVR Access",
        "price": "2500",
        "type": "DSTV"
      }
    ]
  }
}

​
Purchase Add-on

Purchase an add-on package for an existing subscription. 
POST /api/v1/business/vas/cable-tv/purchase-addons
Signature required: Yes

​
Request body

FieldTypeRequiredDescription
referencestringYesYour unique transaction reference
smartCardNumberstringYesCustomer’s smart card number
customerNamestringYesCustomer’s name
typestringYesProvider type
productCodestringYesBase plan code
addOnProductCodestringYesAdd-on code
amountnumberYesAdd-on price in Naira

​
Request example

curl -X POST "https://api-dev.usenumero.com/numerocards/api/v1/business/vas/cable-tv/purchase-addons" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key" \
  -H "x-signature-key: generated_signature" \
  -d '{
    "reference": "ADDON-20240115-001",
    "smartCardNumber": "1234567890",
    "customerName": "John Doe",
    "type": "DSTV",
    "productCode": "DSTV_COMPACT",
    "addOnProductCode": "HDPVR",
    "amount": 2500
  }'