Status: Available Understand the order lifecycle, payment statuses, and refunds.
Overview
An order is created every time a member purchases a product or starts a subscription. Orders track payment status, amounts, and link back to the product or plan that was purchased.
Order Lifecycle
Orders move through these statuses:
- Pending — payment initiated but not yet confirmed
- Paid — payment successful, access granted
- Failed — payment failed, no access granted
- Refunded — full or partial refund processed
- Cancelled — order cancelled before completion
Order Types
- One-time — from a product purchase. Creates a single order
- Recurring — from a plan subscription. A new order is created each billing cycle
Refunds
When you process a refund through Stripe, the order status updates automatically. The Refund Amount field shows the refunded amount. Partial refunds are supported.
After a refund, the member's access permissions are updated accordingly — if the refund is full, access is revoked.
Key Fields
| Field | Purpose |
|---|---|
| Status | Current payment state |
| Type | one_time or recurring |
| Amount / Currency | Payment amount |
| External Payment ID | Stripe Payment Intent or Invoice ID |
| Invoice URL | Link to the Stripe invoice |
Tips
- Check the User Permissions tab on an order to see what access it granted
- Orders are linked to products via the Products relation
- For recurring orders, the Subscription field shows the parent subscription
- Never manually edit order amounts — they're synced from Stripe