Orders & Invoices
One-time purchases, order tracking, and invoices alongside subscription billing.
Overview
Orders complement subscriptions with one-time purchases — add-ons, credits, or digital products. Each order is tracked from creation through payment to fulfillment, with invoices for record-keeping. Orders are part of the billing feature; enable them with "orders": true.
Order lifecycle
Created
An order is initialized with line items and totals.
Pending
A Stripe Checkout session is created and the order awaits payment.
Paid
Stripe confirms payment via webhook and the order is marked paid.
Fulfilled
Your fulfillment logic delivers or activates the purchased items.
Refunded
Optionally, an order can be refunded through Stripe.
Stripe integration
One-time payments use Stripe Checkout sessions in payment mode. The checkout.session.completed webhook marks the order as paid, and an invoice is generated for your records.
Order UI
The billing dashboard includes an order list, an order detail view with line items and status, and order history with date, amount, and status badges.
Extending
To add custom order types, define your line item types on the backend, create checkout sessions with the right items, handle the checkout.session.completed webhook to mark orders paid, and add your fulfillment logic. Display them with the dashboard's billing components.