---
title: "Create a BOLT11 invoice for deposit"
method: POST
path: "/deposits/bolt11"
tags: ["Deposits"]
---

# Create a BOLT11 invoice for deposit

`POST /deposits/bolt11`

Creates a Lightning Network invoice (BOLT11) to deposit funds to the informed participant account.

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Request body

- PostBOLT11Body
  - `amount` string, required — The amount that should be deposited. Max precision of 8 decimals (one satoshi)
  - `participant_code` string, required — The participant code to have the deposit credited to
  - `account_label` string — The `account_label` associated with the participant account. This parameter is case sensitive.
  - `test_mode` boolean — For CERT enviroiment, this flag indicates whether the invoice will be used internally to simulate a payment using our /deposits/bolt11/test_payment endpoint. If set to true, the invoice is not available to be payed at a external TESTNET lightning service.
  - `test_type` 'deposit' | 'withdrawal' — For CERT environment, this field indicates the type of test to be simulated. If test_mode is set to false, this field is ignored". If not provided, Default is `deposit`.
  - `test_memo` string — For CERT environment, set a memo string to mark the test invoice. If test_mode is set to false, test_memo is ignored

## Response `200`

Successfully created BOLT11 Lightning Network invoice. Returns the created resource with generated IDs and timestamps.

- PostBOLT11Response
  - `encoded_invoice` string, required — The encoded BOLT11 invoice the payer should pay to credit the deposit.
  - `expiration` string, date-time, required — The expiration timestamp in RFC3339 format.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/zerohash/apis/zerohash-api.md) · [All operations](https://skmtc.net/zerohash/apis/zerohash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zerohash/zerohash-api/versions/8b647d934363/schema)