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

FieldTypeDescription
successbooleanIndicates if the transaction was successful
codestringStatus code (00000 means success)
messagestringGeneral response message (e.g. “SUCCESSFUL”)
data.orderNostringInternal order number assigned to the transaction
data.referencestringUnique transaction reference sent in the request
data.statusstringStatus of the transaction (e.g., “delivered”)
data.errorMsgstringDetailed message about the transaction result
data.amountnumberPrice of the selected TV package.
data.discountnumberDiscount granted to the merchant.
data.feenumberBill-payment fee charged to the merchant.
data.totalDebitednumberAuthoritative amount removed from the NGN wallet: amount + fee - discount.
data.purchased_codestring or nullProvider 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.