TV Subscription Payment
The TV Subscription Payment API allows users to conveniently pay for their digital TV subscriptions online. By providing details such as the service provider (e.g., GOTV, DSTV, STARTIMES), the smart card number, the subscription package code, and a unique transaction reference, the API processes the payment and activates the subscription for the user.
Endpoint
POST https://backendapi.sayswitchgroup.com/api/v1/tv/pay
cURL Request
curl -X POST https://backendapi.sayswitchgroup.com/api/v1/tv/pay \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_SECRET_KEY" \
-d '{
"provider": "GOTV",
"number": "2019505346",
"code": "gotv-max",
"reference": "20220511035554758"
}'Sample Response
{
"success": true,
"code": "00000",
"message": "SUCCESSFUL",
"data": {
"orderNo": "2026111318502144124979",
"reference": "merchant-tv-order-10001",
"status": "delivered",
"errorMsg": "TRANSACTION SUCCESSFUL",
"amount": 8500,
"discount": 0,
"fee": 100,
"totalDebited": 8600,
"purchased_code": null
}
}Response Field
| Field | Type | Description |
|---|---|---|
| success | boolean | Indicates if the transaction was successful |
| code | string | Status code (00000 means success) |
| message | string | General response message (e.g. “SUCCESSFUL”) |
| data.orderNo | string | Internal order number assigned to the transaction |
| data.reference | string | Unique transaction reference sent in the request |
| data.status | string | Status of the transaction (e.g., “delivered”) |
| data.errorMsg | string | Detailed message about the transaction result |
| data.amount | number | Price of the selected TV package. |
| data.discount | number | Discount granted to the merchant. |
| data.fee | number | Bill-payment fee charged to the merchant. |
| data.totalDebited | number | Authoritative amount removed from the NGN wallet: amount + fee - discount. |
| data.purchased_code | string or null | Provider code returned for products that issue one. |
A pending purchase returns HTTP 202 with status: "pending". Do not submit it again; query the original reference using Status and reconciliation.