Orders

Overview

Orders represent one-time purchases of e-commerce products. Unlike subscriptions, orders are single transactions that can include multiple items (SKUs). Orders track payment status, fulfillment, and shipping information.

How it works

Customer places order — Cart items are converted to an order with payment
Order is paid — Payment is processed and order status updates
Fulfillment — Physical products are shipped, digital products are delivered
Completion — Order is marked as fulfilled or returned

Endpoints

Method	Endpoint	Description
`GET`	`/orders`	List orders
`GET`	`/orders/{id}`	Get order
`POST`	`/orders`	Create order
`PUT`	`/orders/{id}`	Update order

Order statuses

Status	Description
`created`	Order created, awaiting payment
`paid`	Payment received, ready for fulfillment
`canceled`	Order has been canceled
`fulfilled`	All items have been shipped/delivered
`returned`	Order has been returned

Status transitions

From	To
`paid`	`fulfilled`
`fulfilled`	`returned`

Order object

Attribute	Type	Description
`id`	integer	Unique identifier
`user_id`	integer	Customer ID (expandable via `user`)
`address_id`	integer	Shipping address ID (expandable via `address`)
`amount`	integer	Total amount in cents
`currency`	string	Three-letter ISO currency code
`status`	string	Order status
`items`	array	Order items (expandable)
`metadata`	object	Custom key-value metadata
`created_at`	integer	Unix timestamp