Validate cable customer

X-API-Key

POST/cable/validate

Verify a smartcard / IUC before purchase.

Language

curl -X POST "https://api.vendpower.ng/api/v1/cable/validate" \
  -H "X-API-Key: YOUR_X_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "biller_code": "DSTV",
    "customer_id": "1234567890"
  }'

Authentication

Send your approved API key on every request. Keep it on your server only.

Header	Value	Required
X-API-Key	YOUR_X_API_KEY	Yes
Content-Type	application/json	Yes
Accept	application/json	Recommended

Authentication failures (401 / 403 / 429) are listed in Authentication.

Parameters

Body parameters

Name	Type	Required	Description
biller_code	string	Yes	`DSTV` \| `GOTV` \| `STARTIMES`
customer_id	string	Yes	Smartcard / IUC number

Responses

200 OK — Validated

{
  "success": true,
  "message": "Cable customer validated.",
  "data": {
    "biller_code": "DSTV",
    "customer_id": "1234567890",
    "customer_name": "JOHN DOE"
  }
}

Errors

Errors specific to this endpoint, in addition to common authentication and validation failures.

Code	HTTP	When
VALIDATION_FAILED	422	Meter / smartcard / customer could not be verified.
BILLER_NOT_FOUND	404	Unknown or inactive disco / biller for your API scope.