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

# Validate Cable TV

> Verify cable TV smartcard ownership

## Overview

Validate a Cable TV smartcard (e.g., DSTV, GOTV, Startimes) against the provider to ensure it belongs to a valid customer before proceeding with a subscription payment.

## Request Body

<RequestField name="smartcard" type="string" required>
  Customer smartcard or IUC number.
</RequestField>

<RequestField name="provider" type="string" required>
  Cable TV provider from the cable TV catalog.
</RequestField>

## Response Fields

<ResponseField name="name" type="string">
  Customer name returned for the smartcard.
</ResponseField>

<ResponseField name="address" type="string">
  Customer address returned for the smartcard, when available.
</ResponseField>

<ResponseField name="customerType" type="string">
  Customer type returned for the smartcard, when available.
</ResponseField>

<ResponseField name="outstanding" type="number">
  Outstanding amount returned for the smartcard, when available.
</ResponseField>

## Notes

* Call [Cable TV Bouquets](/api-reference/endpoint/cabletvlist) first to get supported providers and packages.
* Use the provider value from the catalog when validating the smartcard.
* Show the returned customer details to the customer before purchase.


## OpenAPI

````yaml POST /validateSmartcard
openapi: 3.0.3
info:
  title: Bleeprs API Specification 0.1
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.bleeprs.com/api
security:
  - bearerAuth: []
paths:
  /validateSmartcard:
    post:
      tags:
        - Vending
      summary: Validate Cable TV
      description: >-
        Verify a cable TV smartcard before purchase and return customer details
        needed for confirmation.
      operationId: validateSmartcard
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                smartcard:
                  type: string
                  description: The customer Cable TV smartcard or IUC number
                  example: '8093245829'
                provider:
                  type: string
                  description: The Cable TV provider (e.g. DSTV, GOTV, STARTIMES)
                  example: DSTV
              required:
                - smartcard
                - provider
      responses:
        '200':
          description: Successfully Processed
          content:
            application/json:
              schema:
                type: object
                properties:
                  gatewayStatus:
                    type: string
                    example: '00'
                  gatewayMessage:
                    type: string
                    example: Successfully Processed
                  requestReference:
                    type: string
                    example: bpr_req_a1b2c3d4e5f6
                  data:
                    type: object
                    properties:
                      name:
                        type: string
                        example: JANE DOE
                      address:
                        type: string
                        example: 123 TEST STREET, IKEJA
                      customerType:
                        type: string
                        example: RESIDENTIAL
                      outstanding:
                        type: number
                        example: 0
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````