Skip to main content

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.

This API is not part of the MVP public surface. These commerce endpoints are intentionally disabled while FLUVEO_MVP=true. Use Products, Prices, Checkout Sessions, Checkout Links, and the billing APIs for MVP integrations.
Orders represent a customer’s purchase. They are created from Checkout Sessions (with mode: order) or directly via the API with line items. Each order tracks payment status, fulfillment status, and includes inventory management — stock is automatically reserved when an order is created and restored if the order is canceled. Orders created from Checkout Sessions with shipping options include shipping_address, billing_address, shipping_method, and shipping_cost fields — populated automatically from the customer’s selections during checkout.
curl -X POST https://api.leanrails.com/v1/orders \
  -u "sk_test_xxx:" \
  -d currency=usd \
  -d "line_items[0][title]=Classic T-Shirt" \
  -d "line_items[0][quantity]=2" \
  -d "line_items[0][unit_price]=2500"

Endpoints

Create an Order

Creates a new order with line items. Inventory is reserved atomically.

List all Orders

Returns a paginated list of orders.

Retrieve an Order

Retrieves an order with its line items.

Update an Order

Updates an order’s metadata.

Cancel an Order

Cancels an open order and restores reserved inventory.

Complete an Order

Marks an order as completed and sets payment status to paid.