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

# Credit notes

> **Status: not supported for public use.** The Credit Note routes answer in test
> mode; live credit notes are not enabled yet. The routes are absent from the API
> Reference and SDK certification. Runtime availability is
> not a Stripe parity or stability guarantee; the exact registration is accounted
> for in the canonical mounted catalog.

A credit note follows Stripe's `credit_note` object. It adjusts an `open`, `paid`
or `uncollectible` [invoice](/billing/invoices): the part of the note up to what is
still owed lowers `amount_due` (a pre-payment credit), and the rest returns money
already paid through a new refund (`refund_amount`), existing refunds
(`refunds[]`), the customer's balance (`credit_amount`) or credit given outside
Fluveo (`out_of_band_amount`). The invoice `total` never changes.

The routes are create, preview and its lines, retrieve, list (by `invoice`,
`customer` or `created`), a note's lines, update (`memo` and `metadata`), void
(while the invoice is `open` or `uncollectible`) and a PDF of the note. Customer
balance transactions are served at `/v1/customers/{id}/balance_transactions`.

Where Fluveo differs from Stripe: notes carry no tax or shipping, no credit-note
email is sent, the PDF is served behind the API key, and a refund is never
advanced beyond the settled funds available. The full list is in the Stripe
divergences register.