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",
            "api_client_id": "10422171-9100-4e66-93e1-7f6da894ef89",
            "api_account_id": "01a10aeb-d989-460a-bbde-9842f2b4320f",
            "rrn": "240809060134"
        },
        "fee": "",
        "timeCreated": "2024-08-09T05: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

​
amount
integer
required

Amount

​
disco
string
required

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

​
merchantTxRef
string
required

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

​
payerName
string
required

The name of the person to be attached to this transaction

​
customerId
string
required

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

​
meterType
string
required

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

​
Response body

​
code
string
required

Response code

​
description
string
required

Response description

​
data
object
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",
            "api_client_id": "10422171-9100-4e66-93e1-7f6da894ef89",
            "api_account_id": "01a10aeb-d989-460a-bbde-9842f2b4320f",
            "rrn": "240809060134"
        },
        "fee": "",
        "timeCreated": "2024-08-09T05:01:35.014Z",
        "id": "API-PHCN-4B8C8-dcc5994c-e110-4035-9017-fc6e497a3baa",
        "type": "phcn",
        "status": "SUCCESS"
    }
}