---
title: "Purchase electricity (vend / postpaid)"
method: POST
path: "/api/external/v1/electricity/buy"
tags: ["VAS"]
---

# Purchase electricity (vend / postpaid)

`POST /api/external/v1/electricity/buy`

## Request body

- object
  - `meterNumber` string, required
  - `productName` string
  - `meterType` 'prepaid' | 'postpaid', required
  - `amount` number, required
  - `customerName` string, required
  - `address` string, required
  - `customerRef` string

## Response `200`

OK

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Internal server error

## Changes

- **2026-05-06** `eefdc20676b6` — 7 warning, 6 info
  - removed the request property `beneficiaryName`
  - removed the request property `billerCode`
  - removed the request property `billerName`
  - removed the request property `deviceKey`
  - …9 more
- **2026-04-23** `bbcdd1c4db49` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/msorg-developers/apis/dancity-api/changes/api/external/v1/electricity/buy/post.md)

---

[API](https://skmtc.dev/msorg-developers/apis/dancity-api.md) · [All operations](https://skmtc.dev/msorg-developers/apis/dancity-api/llms.txt) · [OpenAPI document](https://skmtc.dev/msorg-developers/apis/dancity-api/revisions/64d5f68bab31?raw)