> ## Documentation Index
> Fetch the complete documentation index at: https://docs.handle.ng/llms.txt
> Use this file to discover all available pages before exploring further.

# Electricity DisCos & Meters

> Distribution Companies (DisCos), product codes, test meters, and validation guidelines for Nigerian electricity vending.

# Electricity DisCos & Meter Validation

Handle supports all major Nigerian Electricity Distribution Companies (DisCos) for both **Prepaid (Token generation)** and **Postpaid (Bill settlement)** meter types.

***

## Supported DisCos & Test Data

| DisCo | Product Code | Type | Sandbox Test Meter | Verified Customer Name |
| :- | :- | :- | :- | :- |
| **Abuja Electricity (AEDC)** | `300` | Prepaid / Postpaid | `0219927013063` | Ade |
| **Ikeja Electric (IKEDC)** | `102` | Prepaid | `45702044269` | Adene Jonah |
| **Eko Electricity (EKEDC)** | `101` | Prepaid | `12345678910` | Demo Customer |
| **Ibadan Electricity (IBEDC)** | `103` | Prepaid / Postpaid | `11122233344` | Verified Customer |
| **Enugu Electricity (EEDC)** | `104` | Prepaid / Postpaid | `22233344455` | Verified Customer |
| **Port Harcourt (PHED)** | `105` | Prepaid / Postpaid | `33344455566` | Verified Customer |
| **Benin Electricity (BEDC)** | `106` | Prepaid / Postpaid | `44455566677` | Verified Customer |
| **Kaduna Electric (KAEDC)** | `107` | Prepaid / Postpaid | `55566677788` | Verified Customer |
| **Kano Electricity (KEDCO)** | `108` | Prepaid / Postpaid | `66677788899` | Verified Customer |
| **Jos Electricity (JEDC)** | `109` | Prepaid / Postpaid | `77788899900` | Verified Customer |
| **Yola Electricity (YEDC)** | `110` | Prepaid / Postpaid | `88899900011` | Verified Customer |
| **Aba Power (APLE)** | `112` | Prepaid / Postpaid | `99900011122` | Verified Customer |

***

## 2-Step Electricity Vending Flow

### 1. Validate Meter

Before attempting any payment, validate the meter with `POST /vending/validate`.

```bash theme={null}
curl --location 'https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/vending/validate' \
--header 'secretKey: sk_test_l/pQgOLgziOTzb+7pcUXVH2iX1MlpROsePDkNi/g/QmMs2c8P0DPr1vUP7xESiGG' \
--header 'Content-Type: application/json' \
--data '{
    "productCode": "300",
    "accountNumber": "0219927013063"
}'
```

**Successful Response**:

```json theme={null}
{
  "message": "Success",
  "status": "00",
  "data": {
    "name": "Ade",
    "accountNumber": "0219927013063",
    "productCode": "300",
    "address": "Abuja, FCT",
    "minAmount": 500,
    "maxAmount": 50000
  }
}
```

### 2. Purchase Electricity Token

Execute the transaction with `POST /vending/transactions`.

```bash theme={null}
curl --location 'https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/vending/transactions' \
--header 'secretKey: sk_test_l/pQgOLgziOTzb+7pcUXVH2iX1MlpROsePDkNi/g/QmMs2c8P0DPr1vUP7xESiGG' \
--header 'Content-Type: application/json' \
--data '{
    "productCode": "300",
    "clientReference": "elec_tx_1790769719",
    "amount": 1000,
    "data": {
        "accountNumber": "0219927013063",
        "phoneNumber": "08012345678"
    }
}'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.