v1

latestOpenAPI 3.0.12026-07-2679100267.2 KB

Electricity Vending

Vend electricity via parent account

You can use this endpoint to vend electricity via parent account

post/v1/bill/electricity

Headers

accountIdstring uuid required

Example:890022ce-bae0-45c1-9b9d-ee7872e6ca27

The parent accountId of the business.

Request body

discostring

merchantTxRefstring

This is an idempotency key and must be unique per transaction.

payerNamestring

amountinteger

customerIdstring

meterTypestring

Example request

{
  "disco": "jed",
  "merchantTxRef": "12345",
  "payerName": "John Doe",
  "amount": 1000,
  "customerId": "customer123",
  "meterType": "prepaid"
}

Response

OK - your request was successful.

codestring required

Response Code

descriptionstring required

Response description

Example response

{
  "code": "00",
  "description": "Success",
  "data": {
    "amount": 2000,
    "timeCreated": "2026-02-06T07:09:06.900Z",
    "type": "phcn",
    "meta": {
      "merchantTxRef": "test1116",
      "phcnCustomerAddress": "52, Ajose Street",
      "phcnVendUnits": "23.5",
      "phcnVendToken": "12345678909876543212",
      "meterName": "John Doe",
      "meterType": "PREPAID",
      "rrn": "240626232937",
      "api_client_id": "123456-9100-4e66-93e1-7f6da894ef89",
      "api_account_id": "0167288-d989-460a-bbde-9842f2b4320f"
    },
    "status": "SUCCESS",
    "id": "SUCCESS",
    "fee": "0.0"
  }
}