---
title: "Vend electricity via a specific account"
method: POST
path: "/v1/bill/electricity/{subAccountId}"
tags: ["Electricity Vending"]
deprecated: true
---

# Vend electricity via a specific account

`POST /v1/bill/electricity/{subAccountId}`

## Request

- Base URL: `https://api.nomba.com`
- URL: `https://api.nomba.com/v1/bill/electricity/{subAccountId}`
- Auth: HTTP bearer

> **Deprecated.**

**Deprecated.** This endpoint is deprecated and will be removed in a future release. Use `POST /v2/bill/electricity/{subAccountId}` instead.

## Path parameters

- `subAccountId` string, required

## Headers

- `accountId` string, uuid, required

## Request body

- ElectricityVendingRequest
  - `disco` string
  - `merchantTxRef` string: This is an idempotency key and must be unique per transaction.
  - `payerName` string
  - `amount` integer
  - `customerId` string
  - `meterType` string

## Response `200`

OK - your request was successful.

- object
  - `code` string, required: Response Code
  - `description` string, required: Response description
  - `data` ElectricityVendingResponse, required
    - `amount` number, double, required: The value (in digits) of this transaction
    - `timeCreated` string, date-time, required: The Date and Time of transaction creation
    - `type` string, required: The classification for this type of transaction
    - `meta` object, required: Extra information about this transaction
    - `status` 'SUCCESS' | 'PROCESSING', required: The status of this transaction. `SUCCESS` means it completed; `PROCESSING` means it is still being processed — listen for the webhook or requery the transaction for the final status.
    - `id` string, required: The unique ID of the transaction, e.g. `API-PHCN-4B8C8-dcc5994c-e110-4035-9017-fc6e497a3baa`. Use it to requery the transaction.
    - `fee` string: The associated transaction fee

## Other responses

- `400`: The request body sent by merchant did not pass the validation checks
- `401`: The access_token provided to access the resource is missing or invalid.
- `403`: The client does not have the permissions to access this resource
- `404`: The record that the client is trying to access does not exist.
- `429`: The client has maxed out the number of calls within a time period on this resource.
- `500`: Downstream system error.
- `default`: Resource not available

## Changes

- **2026-11-03** `278a25dccfe5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nomba/apis/vendor-api/changes/v1/bill/electricity/:subAccountId/post.md)

---

[API](https://skmtc.dev/nomba/apis/vendor-api.md) - [All operations](https://skmtc.dev/nomba/apis/vendor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nomba/apis/vendor-api/revisions/278a25dccfe5?raw)