Cable Subscription
These Suit of APIs allow you vend cable subscriptions
BOUQUET LIST
This API allows you to retrieve the bouquet list of a cable provider
POST
https:{{base_url}}
/v1/service/cable/bouquet-list
Request Body
provider*
String
Name of Cable Provider (e.g, GoTV, DSTV)
Sample Request
{
"provider": "GOTV"
}
Sample Response
{
"status": 200,
"success": true,
"message": "Success",
"data": {
"bouquets": [
{
"name": "Smallie",
"platform": "GOTV",
"code": "GOLITE",
"kobo_amount": 157500,
"currency": "NGN",
"provider": "GOTV"
},
{
"name": "Jinja Bouquet",
"platform": "GOTV",
"code": "GOtvNJ1",
"kobo_amount": 330000,
"currency": "NGN",
"provider": "GOTV"
}
]
}
}
ACCOUNT LOOKUP
This API allows you to look up the smartcard number of a provider before vending.
POST
https:{{base_url}}
/v1/service/cable/lookup
REQUEST BODY
provider*
String
Name of Cable Provider (e.g, GoTV, DSTV)
smartcard_number*
String
The smartcard number of the decoder
Sample Request
{
"provider": "GOTV",
"smartcard_number": "4135391280"
}
Sample Response
{
"status": 200,
"success": true,
"message": "Success",
"data": {
"reference": "MLTCHC-250228dd3bccb250f3ed1b",
"customer_name": "ONYENULOYA"
}
}
CABLE SUBSCRIPTION (VEND)
This API allows you to subscribe to a bouquet.
POST
https:{{base_url}}
/v1/service/cable/vend
Request Body
provider*
String
Name of Cable Provider (e.g, GoTV, DSTV)
reference*
String
Reference retrived from account lookup
boquet_code*
String
Provider's boquet package
phone_number*
String
Phone number of the user
email*
String
Email address of the user
Sample Request
{
"provider": "GOTV",
"reference": "MLTCHC-250228dd3bccb250f3ed1b",
"bouquet_code": "GOTVMAX",
"phone_number": "08061234567",
"email": "cable@squadco.com"
}
Sample Response
{
"status": 200,
"success": true,
"message": "Transaction in process, client will be notified",
"data": {
"reference": "MLTCHC-250228dd3bccb250f3ed1b",
"bouquet": {
"platform": "GOTV",
"name": "Max Bouquet",
"code": "GOTVMAX",
"kobo_amount": 720000,
"currency": "NGN",
"provider": "GOTV"
}
}
}
Last updated
Was this helpful?