Verification

Before purchasing electricity or cable TV, verify the meter or decoder number to get customer details.

Verify Electricity Meter

Endpoint: POST /verify

Field	Type	Required	Description
`service_type`	string	Yes	Must be `electricity`
`provider_code`	string	Yes	e.g., `ikeja`, `abuja`
`meter_number`	string	Yes	13‑digit meter number. Test: `1111111111111` (prepaid) or `1010101010101` (postpaid)
`meter_type`	string	Yes	`prepaid` or `postpaid`

Example Request

{
  "service_type": "electricity",
  "provider_code": "ikeja",
  "meter_number": "1111111111111",
  "meter_type": "prepaid"
}

cURL

curl -X POST "https://app.wisesub.com.ng/api/partner/v1/verify" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET" \
  -H "X-Environment: test" \
  -H "Content-Type: application/json" \
  -d '{\n  "service_type": "electricity",\n  "provider_code": "ikeja",\n  "meter_number": "1111111111111",\n  "meter_type": "prepaid"\n}'

Response

{
  "success": true,
  "message": "Customer verified successfully",
  "data": {
    "customer_name": "TESTMETER1",
    "meter_number": "1111111111111",
    "address": "ABULE EGBA BU ABULE",
    "current_bouquet": null,
    "due_date": null,
    "provider": "Ikeja Electric (IKEDC)"
  }
}

Verify Cable TV Decoder

Field	Type	Required	Description
`service_type`	string	Yes	Must be `cabletv`
`provider_code`	string	Yes	`dstv`, `gotv`, `startimes`
`decoder_number`	string	Yes	Smartcard number. Test: `1212121212`

Example Request

{
  "service_type": "cabletv",
  "provider_code": "dstv",
  "decoder_number": "1212121212"
}

cURL

curl -X POST "https://app.wisesub.com.ng/api/partner/v1/verify" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET" \
  -H "X-Environment: test" \
  -H "Content-Type: application/json" \
  -d '{\n  "service_type": "cabletv",\n  "provider_code": "dstv",\n  "decoder_number": "1212121212"\n}'

Response

{
  "success": true,
  "message": "Customer verified successfully",
  "data": {
    "customer_name": "TEST METER",
    "decoder_number": "1212121212",
    "address": null,
    "current_bouquet": null,
    "due_date": "2025-02-06T00:00:00",
    "provider": "DSTV"
  }
}

⚠️

Always verify before purchasing electricity or cable TV – the response contains the customer_name and due_date (for cable TV) to confirm correct account.