> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usenumero.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cable TV

> Subscribe, renew, and manage cable TV subscriptions for DSTV, GOtv, Startimes, and other providers.

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:** No

### Response

```json theme={null}
{
  "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://..."
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": "req_365123ebc73323f1482508560ce6400e",
    "pagination": null
  }
}
```

***

## Get Subscription Plans

Retrieve available subscription plans for a specific provider.

```
GET /api/v1/business/vas/cable-tv/fetch-billers?type={providerType}
```

**Signature required:** No

### Query parameters

| Parameter | Type   | Required | Description                          |
| --------- | ------ | -------- | ------------------------------------ |
| `type`    | string | Yes      | Provider type (e.g., `DSTV`, `GOTV`) |

### Response

```json theme={null}
{
  "data": {
    "success": true,
    "plans": [
      {
        "id": 1,
        "type": "DSTV",
        "code": "DSTV_COMPACT",
        "name": "DStv Compact",
        "description": "DStv Compact Package",
        "price": "10500",
        "amount": "10500"
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": "req_365123ebc73323f1482508560ce6400e",
    "pagination": null
  }
}
```

***

## 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

| Field         | Type   | Required | Description                         |
| ------------- | ------ | -------- | ----------------------------------- |
| `billerId`    | string | Yes      | Provider type (e.g., `DSTV`)        |
| `smartCardNo` | string | Yes      | Customer's smart card or IUC number |

### Request example

```bash theme={null}
curl -X POST "https://api.usenumero.com/numeroaccount/api/v1/business/vas/cable-tv/validate-customer" \
  -H "Content-Type: application/json" \
  -H "X-Numero-Api-Key: your_api_key" \
  -H "X-Numero-Signature: $SIGNATURE" \
  -H "X-Numero-Signature-Version: v2" \
  -d '{
    "billerId": "DSTV",
    "smartCardNo": "1234567890"
  }'
```

### Response

```json theme={null}
{
  "data": {
    "success": true,
    "status": "active",
    "message": "Customer validated",
    "customer": {
      "fullName": "John Doe",
      "biller": "DSTV",
      "iucNumber": "1234567890"
    }
  },
  "error": null,
  "meta": {
    "request_id": "req_365123ebc73323f1482508560ce6400e",
    "pagination": null
  }
}
```

***

## Purchase Subscription

Subscribe or renew a cable TV subscription.

```
POST /api/v1/business/vas/cable-tv/purchase
```

**Signature required:** Yes

### Request body

| Field         | Type    | Required | Description                                 |
| ------------- | ------- | -------- | ------------------------------------------- |
| `reference`   | string  | Yes      | Your unique transaction reference           |
| `type`        | string  | Yes      | Provider type (e.g., `DSTV`)                |
| `code`        | string  | Yes      | Plan code (from subscription plans)         |
| `smartCardNo` | string  | Yes      | Customer's smart card number                |
| `renewal`     | boolean | No       | Whether this is a renewal (default: `true`) |
| `amount`      | number  | Yes      | Plan amount in Naira                        |

### Request example

```bash theme={null}
curl -X POST "https://api.usenumero.com/numeroaccount/api/v1/business/vas/cable-tv/purchase" \
  -H "Content-Type: application/json" \
  -H "X-Numero-Api-Key: your_api_key" \
  -H "X-Numero-Signature: $SIGNATURE" \
  -H "X-Numero-Signature-Version: v2" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "reference": "TV-20240115-001",
    "type": "DSTV",
    "code": "DSTV_COMPACT",
    "smartCardNo": "1234567890",
    "renewal": true,
    "amount": 10500
  }'
```

### Response

```json theme={null}
{
  "data": {
    "success": true,
    "status": "completed",
    "message": "Subscription successful",
    "reference": "TV-20240115-001"
  },
  "error": null,
  "meta": {
    "request_id": "req_365123ebc73323f1482508560ce6400e",
    "pagination": null
  }
}
```

***

## 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

| Parameter | Type   | Required | Description   |
| --------- | ------ | -------- | ------------- |
| `type`    | string | Yes      | Provider type |
| `code`    | string | Yes      | Plan code     |

### Response

```json theme={null}
{
  "data": {
    "success": true,
    "status": "ok",
    "message": "Add-ons retrieved",
    "data": [
      {
        "addOnProductCode": "HDPVR",
        "productCode": "DSTV_COMPACT",
        "name": "HD PVR Access",
        "price": "2500",
        "type": "DSTV"
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": "req_365123ebc73323f1482508560ce6400e",
    "pagination": null
  }
}
```

***

## 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

| Field              | Type   | Required | Description                       |
| ------------------ | ------ | -------- | --------------------------------- |
| `reference`        | string | Yes      | Your unique transaction reference |
| `smartCardNumber`  | string | Yes      | Customer's smart card number      |
| `customerName`     | string | Yes      | Customer's name                   |
| `type`             | string | Yes      | Provider type                     |
| `productCode`      | string | Yes      | Base plan code                    |
| `addOnProductCode` | string | Yes      | Add-on code                       |
| `amount`           | number | Yes      | Add-on price in Naira             |

### Request example

```bash theme={null}
curl -X POST "https://api.usenumero.com/numerocards/api/v1/business/vas/cable-tv/purchase-addons" \
  -H "Content-Type: application/json" \
  -H "X-Numero-Api-Key: your_api_key" \
  -H "X-Numero-Signature: $SIGNATURE" \
  -H "X-Numero-Signature-Version: v2" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "reference": "ADDON-20240115-001",
    "smartCardNumber": "1234567890",
    "customerName": "John Doe",
    "type": "DSTV",
    "productCode": "DSTV_COMPACT",
    "addOnProductCode": "HDPVR",
    "amount": 2500
  }'
```