Reference
Order statuses
Reference for order statuses, payment states, delivery types, and sources.
Statuses
| Status | Meaning | Typical next step |
|---|---|---|
| Pending | New order awaiting payment or phone confirmation | Confirm or cancel |
| Confirmed | Payment confirmed, or COD confirmed with the customer | Start processing |
| Processing | The order is being prepared | Ship it |
| Shipped | Handed to the carrier; tracking may be recorded | Deliver or return |
| Delivered | The customer received the order | Record COD payment if needed |
| Canceled | The order will not be fulfilled | None; stock is restored |
| Returned | The order came back after shipping or delivery | Process refund if due |
Allowed transitions
| From | To |
|---|---|
| Pending | Confirmed, Canceled |
| Confirmed | Processing, Canceled |
| Processing | Shipped, Canceled |
| Shipped | Delivered, Returned |
| Delivered | Returned |
| Canceled | — |
| Returned | — |
The admin enforces these transitions. Bulk status updates skip orders that cannot move to the requested status.
Payment states
| State | Meaning |
|---|---|
PENDING | Payment not collected or not confirmed |
REQUIRES_ACTION | Stripe payment intent needs customer action |
PROCESSING | Payment is being processed |
SUCCEEDED | Payment confirmed |
FAILED | Payment failed |
REFUNDED | Payment was refunded |
The order also has an isPaid flag and paidAt timestamp. Recording a
cash-on-delivery payment marks the order paid without changing its status.
Payment methods
| Method | Meaning |
|---|---|
CASH_ON_DELIVERY | Cash collected on delivery |
STRIPE | Card payment through Stripe |
Delivery types
| Type | Meaning |
|---|---|
HOME | Home delivery to the customer's address |
STOPDESK | Pickup from a carrier desk |
Order sources
| Source | Meaning |
|---|---|
STOREFRONT | Checkout on the storefront |
ADMIN | Created by a staff member |
API | Created by an integration |
Return reasons
REFUSED, CUSTOMER_RETURN, DAMAGED, WRONG_ITEM, NOT_AS_DESCRIBED,
CANCELLATION, OTHER.
Refund methods
CASH, BANK_TRANSFER, STORE_CREDIT, GATEWAY, NONE.