Fluveo gives you a unified API to accept payments, sell products, manage orders, and handle fulfillment — all through clean REST endpoints with predictable, resource-oriented URLs.Documentation Index
Fetch the complete documentation index at: https://docs.fluveo.com/llms.txt
Use this file to discover all available pages before exploring further.
Accept a Payment
Create a PaymentIntent and collect your first payment.
Sell Products Online
Create products, set prices, and start selling.
API Reference
Explore all endpoints with interactive examples.
Build a Marketplace App
Build apps that extend Fluveo for merchants.
Webhooks
Receive real-time notifications for payment and commerce events.
Testing
Test your integration with simulated payment methods.
Core Resources
Payments
| Resource | Description |
|---|---|
| PaymentIntent | Represents a payment attempt. Tracks the lifecycle from creation to settlement. |
| Customer | Stores customer information for recurring payments and record-keeping. |
| Refund | Returns funds to a customer for a completed payment. |
| Checkout Session | A hosted payment page for collecting payments. |
| Checkout Link | A reusable, shareable URL that opens a checkout session. |
Commerce
| Resource | Description |
|---|---|
| Product | A good or service you sell, with variants and images. |
| Price | A pricing configuration attached to a product (one-time or recurring). |
| Collection | A group of products organized for browsing or promotions. |
| Order | A confirmed purchase with line items, shipping, and payment details. |
| Fulfillment | Tracks shipping and delivery for an order. |
| Cart | A shopping session with line items, before checkout. |
| Inventory | Stock levels and adjustments for product variants. |
| Promotion | Discounts and coupon codes applied at checkout. |
Getting Started
Get your API keys
Sign up for an account and grab your test mode secret key (
sk_test_...) from the dashboard under Settings > API Keys.Accept a test payment or create a product
Make a POST request to
/v1/payment_intents to accept a payment, or to /v1/products to create your first product.Handle webhooks
Set up a webhook endpoint to receive real-time notifications for payment and commerce events.
Explore
- Error Handling — Understand error types and handle them gracefully
- Idempotency — Safely retry requests without double-charging
- Pagination — Navigate large result sets efficiently
- Testing — Test your integration with simulated payment methods
- Sell Products Online — Create products, prices, and collections
- Manage Orders — Handle order lifecycle and fulfillment
- Marketplace — Build apps for the Fluveo ecosystem