> 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.

# Billing

> **Status:** Products, prices, invoice items, invoices, and subscriptions are
> `contracted_test` — in the machine-checked test-mode contract
> (`openapi.subset.json`) and the [API Reference](/api-reference), served by the
> `fluveo-billing` sidecar (ADR 0019); promoted 2026-07-13. Coupons, promotion
> codes, and credit notes remain mounted but outside the public contract. See
> [API coverage](/api-coverage).

Fluveo's billing surface — the product catalog, pricing, discounts, invoices, and
subscriptions — is served on `/v1` and backed by a dedicated billing service. The
five core resources are contracted in test mode; coupons, promotion codes, and
credit notes are unavailable until they are added to the canonical contract.

## The version header (optional)

The `Stripe-Version` header is optional on billing endpoints — requests without it
use the server default, and an explicit version is passed through:

**`curl`**

```bash title="curl"
curl -s https://api.devfluveo.com/v1/products \
  -u "$FLUVEO_API_KEY:"
```

Send an `Idempotency-Key` header on POST writes (create invoice, create
subscription) so retries never double-create.

## The billing resources

| Resource                                    | What it is                                          |
| ------------------------------------------- | --------------------------------------------------- |
| [Products](/billing/products)               | The thing you sell                                  |
| [Prices](/billing/prices)                   | A price for a product (one-off or recurring)        |
| [Coupons](/billing/coupons)                 | A reusable discount                                 |
| [Promotion codes](/billing/promotion-codes) | A customer-facing code for a coupon                 |
| [Invoice items](/billing/invoice-items)     | A line added to an upcoming invoice                 |
| [Invoices](/billing/invoices)               | A bill issued to a [customer](/resources/customers) |
| [Subscriptions](/billing/subscriptions)     | Recurring billing on a price                        |
| [Credit notes](/billing/credit-notes)       | A post-issue adjustment to an invoice               |

Products, prices, invoice items, invoices, and subscriptions are in the
[API Reference](/api-reference) today (status `contracted_test`); coupons,
promotion codes, and credit notes are not in the contract yet and will join it
separately.