Skip to navigation
Reference

API coverage

The Fluveo /v1 API is Stripe-shape-compatible. This page is the honest map of what actually responds today, derived from the live API and its canonical OpenAPI contract.

There are three things worth separating, because they are not the same:

  • In the contract — the resource is in the canonical contract, so it appears in the interactive API Reference with schemas and try-it.
  • Served on /v1 — the route is mounted and responds (it may be served even if it is not yet in the contract, so it won’t show in the generated reference).
  • Not supported on /v1 — the route returns a documented Stripe-shaped 404 on purpose; it is a bounded non-launch surface, not an imminent feature.

Live now (launch contract)

These 17 resources are in the contract and appear in the API Reference:

ResourceNotes
Payment IntentsCreate → confirm → capture → cancel lifecycle
ChargesRead-only projection
CustomersCreate, retrieve, update, delete (not available for US Stripe Connect stores), list
Payment MethodsRead-only: retrieve + a customer-scoped list (nested /customers/{id}/payment_methods and top-level ?customer=). Account-wide list (no customer) and attach/detach/create return 404 unsupported_operation
RefundsCreate, retrieve, update, list (first page; starting_after/ending_before accepted but not yet paged — use limit)
BalanceRetrieve
Balance TransactionsRetrieve, list
Checkout SessionsCreate, retrieve, update, list, line_items, expire — backed by real Payment Intents — plus the public hosted payment page GET /c/{cs_id}. Session lifecycle events (checkout.session.*) are not yet emitted
Webhook EndpointsManagement: create, retrieve, update, list, delete. Per-endpoint whsec_ secret and per-event routing via enabled_events. Signed delivery is live — see Webhooks
EventsList (first page; filter by limit + type) and retrieve
Payment LinksAPI live (platform-key); merchant sk_ blocked, dashboard-managed. Create, retrieve, update, list — backed by real Payment Intents — plus the public hosted page GET /p/{plink_id}. Create takes Stripe’s line_items (price or price_data). See Payment Links
Setup IntentsSix TEST operations (create, retrieve, update, confirm, cancel, list). List is a tenant-scoped Stripe list envelope from merchant_setup_intents; it never returns processor-wide rows. See Setup Intents
SubscriptionsBilling endpoint. Create, retrieve, list, and period-end cancel
InvoicesBilling endpoint. Create, retrieve, list, and finalize
Invoice ItemsBilling endpoint. Create
ProductsBilling endpoint. Create, retrieve, list, update, delete. Delete is refused while any price references the product, so archiving (active=false) is the usual verb. Search is not served
PricesBilling endpoint. Create, retrieve, list, update. Update changes only active, nickname, lookup_key, tax_behavior and transfer_lookup_key — amount, currency and product are immutable, as they are in Stripe. Tiered, package, customer-chosen, per-currency and metered pricing are unsupported. Search is not served

Live in code — not in the API Reference yet

These routes are served on /v1 today, but are not yet in the contract, so they don’t appear in the generated API Reference. They’re documented in the Checkout and Billing sections.

ResourceNote
CouponsBilling endpoint, served but not yet in the contract
Promotion CodesBilling endpoint, served but not yet in the contract
Credit NotesBilling endpoint, served but not yet in the contract. Direct creation is refused while money movement is unavailable
TokensCard tokenization route is mounted; tokenization is PCI / card-vault gated (see Tokens)

Why aren’t these in the API Reference? The reference is generated from a machine-checked OpenAPI contract. Adding a served route to that contract is a deliberate, separately-reviewed step — until it lands, the route works but isn’t in the generated reference.

Not supported on /v1 (documented 404)

These return a documented Stripe-shaped 404 unsupported by design — a bounded, non-launch surface, never a fake partial-parity success. Some belong to resources whose webhook event types are still accepted on an endpoint but stay dormant until the resource ships.

ResourceNote
Disputes404 unsupported on /v1 — see Disputes
Payouts404 unsupported on /v1 — see Payouts
Mandates404 unsupported on /v1 — see Mandates
Files404 unsupported on /v1
Tax, Issuing, Treasury, Terminal, Identity, Connect404 unsupported on /v1

In total: 12 live (in the API Reference) · 9 served but not yet contracted · 0 not on /v1 yet · 10 unsupported on /v1.

SDKs

SDKs are not supported, including the official Stripe SDKs. Call the API directly (see the curl examples in the API Reference). The supported path is the /v1 HTTP API, the Fluveo integration skill for AI coding agents, and the published API Reference. See Migrate from Stripe.