Cable TV API - IA-Café Documentation

📡 Quick Overview

POST /devapi/v1/cable

📺

All Providers

DStv, GOtv, Startimes, Showmax

🎬

All Bouquets

From basic to premium packages

⚡

Instant Activation

Subscription activates immediately

📋 Step 1: Get Available Bouquets

GET /devapi/v1/variations?product=cable&service_id=dstv

cURL - Get DStv Bouquets

curl -X GET "https://iacafe.com.ng/devapi/v1/variations?product=cable&service_id=dstv" \
  -H "Authorization: Bearer YOUR_API_KEY"

                    Response
                

{
  "code": "success",
  "data": [
    { "variation_id": "2701", "name": "DStv Padi", "price": "2500" },
    { "variation_id": "2702", "name": "DStv Yanga", "price": "3500" },
    { "variation_id": "2703", "name": "DStv Confam", "price": "6200" },
    { "variation_id": "2704", "name": "DStv Compact", "price": "10500" },
    { "variation_id": "2705", "name": "DStv Compact Plus", "price": "16600" },
    { "variation_id": "2706", "name": "DStv Premium", "price": "24500" }
  ]
}
                

📋 Request Parameters

Parameter	Type	Required	Description
`request_id`	string	Yes	Your unique transaction ID
`customer_id`	string	Yes	Smartcard/IUC number
`service_id`	string	Yes	`dstv`, `gotv`, `startimes`, `showmax`
`variation_id`	string	Yes	Bouquet ID from variations endpoint

💻 Code Example

cURL - Subscribe to DStv Compact

curl -X POST "https://iacafe.com.ng/devapi/v1/cable" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_id": "cable_dstv_1704067200_xyz",
    "customer_id": "1234567890",
    "service_id": "dstv",
    "variation_id": "2704"
  }'

📤 Response Example

                    Success Response
                    
                

{
  "code": "success",
  "message": "ORDER COMPLETED",
  "data": {
    "product_name": "Cable TV",
    "service_name": "DStv",
    "status": "completed-api",
    "order_id": 12348,
    "customer_id": "1234567890",
    "customer_name": "JOHN DOE",
    "bouquet": "DStv Compact",
    "subscription_type": "Renewal",
    "amount": 10500,
    "discount": "210.00",
    "amount_charged": "10290.00",
    "request_id": "cable_dstv_1704067200_xyz"
  }
}
                