curl --location 'https://api.nomba.com/v1/bill/electricity' \
--header 'accountId: <accountId>' \
--header 'Authorization: Bearer <token>' \
--data '{
    "disco": "phcn",
    "merchantTxRef": "c006475e-a76f-4533-b2ff-59a67d5e6241",
    "payerName": "John Doe",
    "amount": 2000,
    "customerId": "1234567890",
    "meterType": "PREPAID"
}'

{
    "code": "00",
    "description": "SUCCESS",
    "data": {
        "amount": 2000,
        "meta": {
            "merchantTxRef": "c006475e-a76f-4533-b2ff-59a67d5e6241",
            "phcnCustomerAddress": "52, Ajose Street",
            "phcnVendUnits": "23.5",
            "phcnVendToken": "12345678909876543212",
            "meterName": "John Doe",
            "meterType": "PREPAID",
            "api_client_id": "10422171-9100-4e66-93e1-7f6da894ef89",
            "api_account_id": "01a10aeb-d989-460a-bbde-9842f2b4320f",
            "rrn": "240809060134"
        },
        "fee": "",
        "timeCreated": "2026-02-06T05:01:35.014Z",
        "id": "API-PHCN-4B8C8-dcc5994c-e110-4035-9017-fc6e497a3baa",
        "type": "phcn",
        "status": "SUCCESS"
    }
}

Pay for Electricity via the Parent Account

`POST /v1/bill/electricity`

Request body

integer

required

Amount

string

required

Electricity provider’s id (e.g. phed, jed, ibedc etc) - This id can be gotten from doing a fetch of available providers

string

required

Merchant Transaction Reference (a unique reference to identify this transaction on your system)

string

required

The name of the person to be attached to this transaction

string

required

An unique id to identify the customer to which this payment belongs

string

required

The meter type to of the meter for which this payment is for. Usually PREPAID or POSTPAID

Response body

string

required

Response code

string

required

Response description

object

Hide object

string

required

Amount

object

Show object

string

Merchant Transaction Reference

string

Electricity Units

string

Meter Name

string

Customer’s Address

string

Meter Token

string

Prepaid or Postpaid

string

Retrieval Reference Number (RRN)

string

required

Date and Time of the transaction

string

required

The type of this transaction. This is most probably phcn in this case

string

required

The status of this transaction

curl --location 'https://api.nomba.com/v1/bill/electricity' \
--header 'accountId: <accountId>' \
--header 'Authorization: Bearer <token>' \
--data '{
    "disco": "phcn",
    "merchantTxRef": "c006475e-a76f-4533-b2ff-59a67d5e6241",
    "payerName": "John Doe",
    "amount": 2000,
    "customerId": "1234567890",
    "meterType": "PREPAID"
}'

{
    "code": "00",
    "description": "SUCCESS",
    "data": {
        "amount": 2000,
        "meta": {
            "merchantTxRef": "c006475e-a76f-4533-b2ff-59a67d5e6241",
            "phcnCustomerAddress": "52, Ajose Street",
            "phcnVendUnits": "23.5",
            "phcnVendToken": "12345678909876543212",
            "meterName": "John Doe",
            "meterType": "PREPAID",
            "api_client_id": "10422171-9100-4e66-93e1-7f6da894ef89",
            "api_account_id": "01a10aeb-d989-460a-bbde-9842f2b4320f",
            "rrn": "240809060134"
        },
        "fee": "",
        "timeCreated": "2026-02-06T05:01:35.014Z",
        "id": "API-PHCN-4B8C8-dcc5994c-e110-4035-9017-fc6e497a3baa",
        "type": "phcn",
        "status": "SUCCESS"
    }
}

Introduction

Getting Started

Products

API Basics

Guides

Pay for Electricity

Pay for Electricity via the Parent Account

`POST /v1/bill/electricity`

Request body

Response body

Pay for Electricity via the Parent Account

​POST /v1/bill/electricity

​Request body

​Response body

`POST /v1/bill/electricity`

Request body

Response body