---
title: "Create Static Charge"
method: POST
path: "/v0/static-charges"
tags: ["Lightning Charges"]
---

# Create Static Charge

`POST /v0/static-charges`

Start accepting payments on Lightning with Static QR codes.

## Headers

- `Content-Type` string

## Request body

- object
  - `minAmount` string — Minimum allowed amount for the Static Charge -> in millisatoshis
  - `maxAmount` string — Maximum allowed amount for the Static Charge -> in millisatoshis
  - `description` string — Note or comment for this Static Charge (visible to payer)
  - `successMessage` string — Message displayed to the payer AFTER payment settles. Maximum of 144 characters.
  - `allowedSlots` number — Number of payments this Static Charge can accept
  - `internalId` string — Open metadata string property
  - `callbackUrl` string — The endpoint ZBD will POST Charge updates to
  - `identifier` string — Used for Custom Lightning Addresses (see guide)

## Response `200`

Successful response

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

## Changes

- **2025-04-18** `b749c336df59` — 1 warning, 1 info
  - deleted the `header` request parameter `apikey`
  - the endpoint scheme security `apikeyAuth` was added to the API
- **2025-04-18** `028610bc46ff` — 1 breaking
  - the `header` request parameter `apikey` became required

[Change history](https://skmtc.dev/zbdpay/apis/zbd-payments-api/changes/v0/static-charges/post.md)

---

[API](https://skmtc.dev/zbdpay/apis/zbd-payments-api.md) · [All operations](https://skmtc.dev/zbdpay/apis/zbd-payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zbdpay/zbd-payments-api/revisions/0d5fdd96023d/schema)