✅ Verify Customer API
Validate meter numbers and smartcard IDs before making payments. This prevents failed transactions and ensures the correct customer receives the service.
🔍 Quick Overview
POST
/devapi/v1/verify-customer
Always Verify Before Purchase!
Electricity and TV transactions are non-reversible.
Always verify customer details before making a purchase.
📋 Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
customer_id |
string | Yes | Meter number or smartcard/IUC number |
service_id |
string | Yes | DisCo or TV provider identifier |
variation_id |
string | Electricity Only | prepaid or postpaid |
💻 Code Examples
Verify Electricity Meter
cURL
curl -X POST "https://iacafe.com.ng/devapi/v1/verify-customer" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"customer_id": "12345678901",
"service_id": "ikeja-electric",
"variation_id": "prepaid"
}'
Verify TV Smartcard
cURL
curl -X POST "https://iacafe.com.ng/devapi/v1/verify-customer" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"customer_id": "1234567890",
"service_id": "dstv"
}'
📤 Response Example
Success Response
{
"code": "success",
"message": "CUSTOMER VERIFIED",
"data": {
"status": "ok",
"service_name": "Ikeja (IKEDC)",
"customer_name": "JOHN ADEBAYO DOE",
"customer_address": "123 Lagos Street, Ikeja",
"customer_id": "12345678901"
}
}