NOnomba
Electricity Vending

Vend electricity via sub account

Changed on

You can use this endpoint to vend electricity via a sub account

post/v2/bill/electricity/{subAccountId}

Request

  • Base URL
    https://api.nomba.com
  • URL
    https://api.nomba.com/v2/bill/electricity/{subAccountId}
  • Auth
    HTTP bearer

Path parameters

subAccountIdstring required

The identifier for the account through which this transaction is to be carried out.

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.

code'200' | '201' | '400' | '401' | '403' | '429' | '500' required

Response code. This reflects the HTTP status code of the response, e.g. 200 when the request completed successfully and 201 when it was accepted and is still being processed.

descriptionstring required

Response description

messagestring

Response message

statusboolean

Whether the request was successful

Example response

{
  "code": "200",
  "description": "SUCCESS",
  "message": "Transaction completed Successfully",
  "status": true,
  "data": {
    "id": "API-PHCN-28958-37da63af-8daa-4cb7-9070-e32920e38c12",
    "status": "SUCCESS",
    "type": "phcn",
    "amount": 1000,
    "source": "api",
    "customerBillerId": "12345678902",
    "productId": "benin",
    "meta": {
      "payment_type": "prepaid",
      "api_rrn": null,
      "biller_account_name": "John Doe",
      "rrn": null,
      "api_account_id": "0167288-d989-460a-bbde-9842f2b4320f",
      "api_client_id": "05cc8ef7-3aa6-408a-9cde-1a91fd20f592",
      "user_id": "0167288-d989-460a-bbde-9842f2b4320f",
      "merchantTxRef": "310120260017AM",
      "allowDuplicate": true,
      "sender_name": "Josh Doe",
      "idempotentKey": "0167288-d989-460a-bbde-9842f2b4320f_310120260017AM",
      "pos_withdrawal_id": "0167288-d989-460a-bbde-9842f2b4320f_310120260017AM",
      "userName": "John Doe",
      "isCorporate": "true",
      "currency": "NGN",
      "hooksEligible": "true",
      "isSubscribedToSavingsService": false,
      "isSubscribedToLoanService": false,
      "txnAlertEligible": false,
      "banking_entity_id": 189585760,
      "banking_entity_user_id": 188595905,
      "banking_entity_type": "CORPORATE",
      "transactionCategory": "Bills & Utility",
      "meterNumber": "12345678901",
      "amount_charged": "1000.0",
      "paymentVendor": "wallet",
      "wallet_balance": "3055.85",
      "wallet_currency": "NGN",
      "paymentVendorReference": "6ab8d20521deef068755e6a2",
      "gatewayMessage": "Token: 43557934939308375700",
      "billingServiceResponse": "Token: 43557934939308375700",
      "phcnToken": "43557934939308375700",
      "phcnCustomerName": "Mr Johnson",
      "phcnCustomerAddress": "29 Okabiri Street ",
      "phcnCustomerPhone": "09012345678",
      "phcnVendToken": "14557934939308375701",
      "phcnVendUnits": "16.4",
      "meterDebt": "unknown",
      "units": "16.4",
      "income": "21.0",
      "paymentFee": 0,
      "tx_revenue": "21.0"
    },
    "timeCreated": "2026-09-27T08:21:25.582+00:00"
  }
}

Changes