Validate

This is a compulsory operation that must be carried out before any purchase is done on any valid multichoice smartcard account. See the Account finder service for more details.

POST {{BASE_URL}}/api/biller/tv/validate

This method returns some very vital information, that we need to pay attention to. 1. The full name of the valid owner of the account. 2. It also returns the current bouquet plan of the user if available. 3. The due date of the current subscription 4. The outstanding balance that the customer is expected to pay in case of a renewal of a subscription plan.

For DSTV, the service type is "dstv". For GOTV, the service type is "gotv". SEE THE REQUEST / RESPONSE TAB BELOW

Headers

Name	Type	Description
x-api-key*	string	3434-4243-ffef-2323
content-type*	string	application/json

Request Body

Name	Type	Description
provider*	string	This is the service type e.g gotv, dstv, etc
account*	string	This is the decorder card number

200: OK Under the "user" Object, 1. The "name" property contains the name of the valid smartcard account holder. 2. The "outstandingBalance" property contains the amount the user is expected to pay. And this is mandatory to be displayed in the case of subscription renewal.

{
  "isSuccessful": true,
  "message": "string",
  "code": "string",
  "data": {
    "user": {
      "accountNumber": "string",
      "address": "string",
      "name": "string",
      "district": "string",
      "outstandingBalance": "string"
    }
  }
}