Cable TV

GET /api/v1/business/vas/cable-tv/fetch-providers

{
  "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 /api/v1/business/vas/cable-tv/fetch-billers?type={providerType}

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

POST /api/v1/business/vas/cable-tv/validate-customer

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

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

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

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
  }'

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

GET /api/v1/business/vas/cable-tv/fetch-tv-add-ons?type={providerType}&code={planCode}

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

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

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
  }'