The Fluveo /v1 API, generated from the code that serves it. These pages describe documented parameters; they are not an exhaustive allow-list. Call it over plain HTTP; install no payments SDK.
| What | Value |
|---|---|
| Base URL | https://api.fluveo.com/v1 |
| Authentication | Authorization: Bearer sk_test_..., the store's secret key |
| Request body | application/x-www-form-urlencoded, nested keys as metadata[order_id]=1042 |
| Idempotency | Idempotency-Key on every POST, 1 to 255 characters, kept 7 days; 24 hours on POST /v1/checkout/sessions, POST /v1/checkout/sessions/{session} and POST /v1/webhook_endpoints, where webhook endpoint keys are also capped at the newest 32 per store and mode |
| API version | 2026-05-27.dahlia is the only one; send no Fluveo-Version header |
| Amounts | integers in the smallest unit of the currency: 2000 is 20.00 |
| Lists | limit 1 to 100 (default 10), cursors starting_after and ending_before |
Preview#
An operation or a parameter marked Preview works today, but it is not locked yet, so it may change. What has no mark is locked. Today 62 of 115 operations are in preview.
Resources#
PaymentIntents8 operations, with parameters and examples.Charges4 operations, with parameters and examples.Refunds6 operations, with parameters and examples.Disputes4 operations, with parameters and examples.Early fraud warnings2 operations, with parameters and examples.PaymentMethods7 operations, with parameters and examples.Customers10 operations, with parameters and examples.Products6 operations, with parameters and examples.Prices5 operations, with parameters and examples.Balance5 operations, with parameters and examples.Balance transactions2 operations, with parameters and examples.Payouts5 operations, with parameters and examples.Reserves6 operations, with parameters and examples.Events2 operations, with parameters and examples.Webhook endpoints5 operations, with parameters and examples.Checkout Sessions6 operations, with parameters and examples.SetupIntents7 operations, with parameters and examples.Payment links5 operations, with parameters and examples.Wallets10 operations, with parameters and examples.Files and file links7 operations, with parameters and examples.Account3 operations, with parameters and examples.
Objects#
The API's messages link to these objects here; each one's attributes are on its resource page.
The balance object#
The balance object lists its attributes.
The token object#
The token object lists its attributes.