Billing | Fluveo

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

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

$ curl -s https://api.fluveo.dev/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	The thing you sell
Prices	A price for a product (one-off or recurring)
Coupons	A reusable discount
Promotion codes	A customer-facing code for a coupon
Invoice items	A line added to an upcoming invoice
Invoices	A bill issued to a customer
Subscriptions	Recurring billing on a price
Credit notes	A post-issue adjustment to an invoice

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