> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.tiankii.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.tiankii.com/_mcp/server.

# Overview

## Checkout Invoice — Base: `/v1/invoice`

The invoices in this folder are the **checkout invoices**: the actual **Lightning/on-chain charge** generated when someone pays —whether from a payment link, an invoice, a POS sale or an integration—. Each one tracks amount, status, payment method and charge events.

> ⚠️ **Don't confuse them** with **invoices** (payment requests of type `INVOICE`): those are the *bill* that is issued; these are the *charge* that is executed.

Endpoints: create, list, status, get by id, events, update payment method, payment notification, reopen, cancel and mark as paid.

Scopes: `Merchant.invoice.{read,create,update,delete}`.