Skip to main content
GET
Verify Customer

Request

string
required
Bearer token: Bearer <api-key>
string
required
Service type. Either cable_tv or electricity
string
required
Provider ID. E.g. dstv, gotv, startimes, ikeja-electric, eko-electric
string
required
The smartcard number (Cable TV) or meter number (Electricity)
string
Electricity only. prepaid or postpaid. Defaults to prepaid if not provided.

Examples


Response

string
success or error
object
✅ Success 200:
❌ Invalid Account 404:

Integration Flow

1

User enters account number

Collect the meter or smartcard number in your UI.
2

Call GET /services/verify

Pass the account number, service ID, and type to our verification endpoint.
3

Show customer_name prominently

Display the name clearly. E.g. “Recharging account for: JOHN DOE”
4

User confirms

Only proceed if the user confirms the name matches their account.
5

Call POST /purchase

Proceed with the purchase using the same account_number and service_id.
This endpoint is mandatory before any Cable TV or Electricity purchase. Funds sent to the wrong account cannot be reversed.