Orders

An order is a customer's request to purchase items. PaymentsAI splits orders into two kinds:

• Subscriptions — recurring orders, charged on a schedule defined by the plan's recurringInterval. See Subscriptions.
• One-time orders — a single purchase with no renewal. See One-time order.

Every order generates at least one invoice. A subscription generates a new invoice for each billing cycle.

Pages in this section

Page	Covers
Subscriptions	What a subscription is and the supported subscription models.
One-time order	One-time orders and how they differ from subscriptions.
Subscription flow	End-to-end flow from product creation to first renewal.
Subscription statuses	The full set of subscription statuses.
Hosted payment form	How the hosted form processes the first payment.
Required fields	The fields a subscription POST must include.
Subscription pauses	Pausing and resuming subscriptions.
Subscription cancellations	Immediate and scheduled cancellation.
Subscription reactivation	Reactivating a canceled subscription.
Upgrade and downgrade	Changing the plan on an active subscription.
Proration	How partial cycles are billed on plan changes.
Dunning and retries	Retry behavior when a renewal payment fails.
Billing cycles	Anchor dates and billing timing.
Subscription webhooks	Webhook events for the subscription lifecycle.
Migration from another provider	Importing an existing subscription book.
Subscription troubleshooting	Patterns that look like they should work but don't.