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

# TV

> Pay for a TV subscription package.

Submit a TV subscription payment after selecting the package and confirming the customer number when required. Keep the reference for receipt display and follow-up status checks.

## Request body

<ParamField body="customer_id" type="string" required>
  Smartcard number, IUC number, or customer identifier for the TV provider.
</ParamField>

<ParamField body="product_name" type="string" required>
  TV package selected from List products.
</ParamField>

<ParamField body="reference" type="string" required>
  Unique transaction reference from your system. Must be 15 to 40 characters.
</ParamField>

## Request

```json theme={null}
{
  "customer_id": "1234567890",
  "product_name": "dstv-padi",
  "reference": "merchant-ref-20260812003"
}
```

## Successful response

```json theme={null}
{
  "status": true,
  "message": "Purchase processed successfully.",
  "data": {
    "reference": "merchant-ref-20260812003",
    "customer_id": "1234567890",
    "service": "tv",
    "provider": "DSTV",
    "product_name": "dstv-padi",
    "quantity": "3600",
    "paid_amount": 3600,
    "transaction_status": "successful",
    "remark": "Purchase successful"
  }
}
```

## Processing response

```json theme={null}
{
  "status": true,
  "message": "Purchase is processing.",
  "data": {
    "reference": "merchant-ref-20260812003",
    "customer_id": "1234567890",
    "service": "tv",
    "provider": "DSTV",
    "product_name": "dstv-padi",
    "quantity": "3600",
    "paid_amount": 3600,
    "transaction_status": "processing"
  }
}
```

## Failed response

```json theme={null}
{
  "status": false,
  "message": "Error message"
}
```