> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.tiankii.com/api-reference/tiankii-api-api-key/invoice/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}`.


## API Docs

- Checkout Invoice [List invoices](https://docs.tiankii.com/api-reference/tiankii-api-api-key/invoice/list.md)
- Checkout Invoice [Create invoice](https://docs.tiankii.com/api-reference/tiankii-api-api-key/invoice/create.md)
- Checkout Invoice [Get invoice](https://docs.tiankii.com/api-reference/tiankii-api-api-key/invoice/get.md)
- Checkout Invoice [Get invoice status](https://docs.tiankii.com/api-reference/tiankii-api-api-key/invoice/get-status.md)
- Checkout Invoice [Get checkout payload](https://docs.tiankii.com/api-reference/tiankii-api-api-key/invoice/get-checkout.md)
- Checkout Invoice [List invoice events](https://docs.tiankii.com/api-reference/tiankii-api-api-key/invoice/list-events.md)
- Checkout Invoice [Re-check invoice status](https://docs.tiankii.com/api-reference/tiankii-api-api-key/invoice/recheck.md)
- Checkout Invoice [Update payment method](https://docs.tiankii.com/api-reference/tiankii-api-api-key/invoice/update-payment-method.md)
- Checkout Invoice [Send paid notification](https://docs.tiankii.com/api-reference/tiankii-api-api-key/invoice/send-notification.md)
- Checkout Invoice [Reopen invoice](https://docs.tiankii.com/api-reference/tiankii-api-api-key/invoice/reopen.md)
- Checkout Invoice [Cancel invoice](https://docs.tiankii.com/api-reference/tiankii-api-api-key/invoice/cancel.md)
- Checkout Invoice [Mark as paid](https://docs.tiankii.com/api-reference/tiankii-api-api-key/invoice/mark-as-paid.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.tiankii.com/api-reference/tiankii-api-api-key/invoice/openapi.json)
- [OpenAPI YAML](https://docs.tiankii.com/api-reference/tiankii-api-api-key/invoice/openapi.yaml)