Electricity | RizPay Developer API

Pay prepaid and postpaid electricity bills for all major Nigerian distribution companies.

Supported Distributors

Code	Name	Region
`IKEDC`	Ikeja Electric	Lagos (Ikeja)
`EKEDC`	Eko Electric	Lagos (Eko)
`AEDC`	Abuja Electric	Abuja
`KEDC`	Kaduna Electric	Kaduna
`JEDC`	Jos Electric	Jos
`IBEDC`	Ibadan Electric	Ibadan
`KAEDC`	Kano Electric	Kano
`EEDC`	Enugu Electric	Enugu
`PhED`	Port Harcourt Electric	Port Harcourt
`BEDC`	Benin Electric	Benin
`ABA`	Aba Power	Aba
`YEDC`	Yola Electric	Yola

Purchase Flow

Electricity purchases require a two-step process:

Verify - Validate the meter number and get customer details
Purchase - Make the payment

This prevents payments to invalid meters.

Step 1: List Products

bash

curl -X GET \
  -H "Authorization: Bearer sk_live_your_secret_key" \
  "https://my.rizpay.app/api/partners/v1/products/electricity?distributor=IKEDC"

Response:

json

{
  "status": { "code": 200, "message": "Success" },
  "data": [
    {
      "id": "prd_8152",
      "type": "electricity",
      "attributes": {
        "display_name": "Ikeja Electric Payment - IKEDC",
        "distributor": "Ikeja Electric Payment - IKEDC",
        "meter_type": null,
        "min_amount": "100.0",
        "max_amount": "100000.0",
        "price": {
          "currency": "NGN",
          "basis": "face_value",
          "min_amount": "100.00",
          "max_amount": "100000.00"
        }
      }
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total_pages": 1,
    "total_count": 12
  }
}

Product ids are numeric with a prd_ prefix (e.g. prd_8152). There is one product per distribution company. meter_type on the product is null: you supply the meter type (prepaid or postpaid) on the purchase request, and verify returns the meter type it detected.

The `price` block

Electricity is variable: the partner chooses the amount. RizPay returns the supported range as a face_value tuple. You'll be billed exactly the amount you submit on the purchase request.

Step 2: Verify Meter

Required before purchase. Validates the meter and returns customer details.

bash

curl -X POST \
  -H "Authorization: Bearer sk_live_your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "prd_8152",
    "meter_number": "12345678901",
    "meter_type": "prepaid"
  }' \
  https://my.rizpay.app/api/partners/v1/purchases/verify

Response:

json

{
  "status": { "code": 200, "message": "Verification successful" },
  "data": {
    "verified": true,
    "product_id": "prd_8152",
    "product_type": "electricity",
    "price": {
      "currency": "NGN",
      "basis": "face_value",
      "min_amount": "100.00",
      "max_amount": "100000.00"
    },
    "customer": {
      "meter_number": "12345678901",
      "meter_type": "prepaid",
      "customer_name": "JOHN DOE",
      "address": "123 Main Street, Ikeja, Lagos",
      "distributor": "Ikeja Electric Payment - IKEDC"
    }
  }
}

The price block on verify gives you the supported amount range for the verified meter so you can prompt your end-user before submitting the purchase.

Verification Errors

If the meter number cannot be validated, verify returns a 400 with error.code set to VALIDATION_ERROR and a message describing the problem. If the distributor itself is unavailable, purchases for that product return PRODUCT_UNAVAILABLE.

Error	Meaning
`VALIDATION_ERROR`	Meter number could not be verified
`PRODUCT_UNAVAILABLE`	Distributor service is down

Step 3: Make Purchase

After verification, make the purchase. Include the meter_type (prepaid or postpaid) you verified:

bash

curl -X POST \
  -H "Authorization: Bearer sk_live_your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "prd_8152",
    "meter_number": "12345678901",
    "meter_type": "prepaid",
    "amount": "5000.00",
    "phone_number": "08012345678",
    "external_reference": "1736234400D4E5F6"
  }' \
  https://my.rizpay.app/api/partners/v1/purchases

Response:

json

{
  "status": { "code": 201, "message": "Purchase created successfully" },
  "data": {
    "id": "txn_abc123",
    "type": "transaction",
    "attributes": {
      "amount": "5000.0",
      "currency": "NGN",
      "status": "pending",
      "category": "purchase",
      "description": "Purchase of IKEDC Electricity",
      "reference": "elec0order0001abcd",
      "external_reference": "1736234400D4E5F6",
      "product_type": "electricity",
      "phone_number": "08012345678",
      "meter_number": "12345678901",
      "price": {
        "product_amount": "5000.00",
        "fee_amount": "0.00",
        "total_debit": "5000.00",
        "currency": "NGN",
        "basis": "face_value"
      },
      "created_at": "2026-05-18T10:30:00+01:00",
      "updated_at": "2026-05-18T10:30:00+01:00"
    }
  }
}

The `price` breakdown

Same shape as airtime. basis is face_value because the partner picked the amount.

Successful Purchase

Poll the transaction (or use webhooks) until status reaches successful. The completed purchase uses the same nested shape as the create response. For a prepaid meter the recharge token appears inside data.attributes.token:

json

{
  "status": { "code": 200, "message": "Purchase details retrieved" },
  "data": {
    "id": "txn_abc123",
    "type": "transaction",
    "attributes": {
      "amount": "5000.0",
      "currency": "NGN",
      "status": "successful",
      "category": "purchase",
      "description": "Purchase of IKEDC Electricity",
      "reference": "elec0order0001abcd",
      "external_reference": "1736234400D4E5F6",
      "product_type": "electricity",
      "phone_number": "08012345678",
      "meter_number": "12345678901",
      "token": "1234-5678-9012-3456-7890",
      "price": {
        "product_amount": "5000.00",
        "fee_amount": "0.00",
        "total_debit": "5000.00",
        "currency": "NGN",
        "basis": "face_value"
      },
      "created_at": "2026-05-18T10:30:00+01:00",
      "updated_at": "2026-05-18T10:30:05+01:00"
    }
  }
}

Important: For prepaid meters, provide the token to the customer. They'll enter it into their meter to load the units. The token field is present only once the purchase is successful and only for prepaid meters. There is no separate completion timestamp: use updated_at.

Complete Example

javascript

// Generate external reference: 10-digit timestamp + 6 alphanumeric
function generateReference() {
  const timestamp = Math.floor(Date.now() / 1000);
  const chars =
    "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
  let suffix = "";
  for (let i = 0; i < 6; i++) {
    suffix += chars.charAt(Math.floor(Math.random() * chars.length));
  }
  return `${timestamp}${suffix}`;
}

async function payElectricity(meterNumber, meterType, amount, phoneNumber) {
  const API_KEY = "sk_live_your_secret_key";
  const BASE_URL = "https://my.rizpay.app/api/partners/v1";

  // Step 1: Find the product (one per distributor)
  const productsRes = await fetch(
    `${BASE_URL}/products/electricity?distributor=IKEDC`,
    { headers: { Authorization: `Bearer ${API_KEY}` } }
  );
  const products = await productsRes.json();
  const product = products.data[0];

  // Step 2: Verify meter
  const verifyRes = await fetch(`${BASE_URL}/purchases/verify`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      product_id: product.id,
      meter_number: meterNumber,
      meter_type: meterType,
    }),
  });

  const verification = await verifyRes.json();
  if (!verification.data.verified) {
    throw new Error("Invalid meter number");
  }

  // Step 3: Make purchase
  const purchaseRes = await fetch(`${BASE_URL}/purchases`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      product_id: product.id,
      meter_number: meterNumber,
      meter_type: meterType,
      amount: amount,
      phone_number: phoneNumber,
      external_reference: generateReference(),
    }),
  });

  return await purchaseRes.json();
}

Meter Types

Type	Description	Token
`prepaid`	Pay before use	Yes - customer enters token
`postpaid`	Pay after use	No - payment credits account

Required Scope

Requires the purchase_electricity scope on your API key.

Next Steps

Cable TV - Subscribe to cable TV
Webhooks - Get notified when payment completes

Supported Distributors

Purchase Flow

Step 1: List Products

The price block

Step 2: Verify Meter

Verification Errors

Step 3: Make Purchase

The price breakdown

Successful Purchase

Complete Example

Meter Types

Required Scope

Next Steps

The `price` block

The `price` breakdown