Subscriptions & Orders

Subscriptions are created by completing orders. Treat the order as the checkout record and the subscription as the recurring agreement that follows.

Integration flow

1. Create or reuse a customer.
2. Store a reusable payment method for recurring billing.
3. Create an order with one or more recurring prices.
4. Complete the order.
5. Read the subscriptions created from the order.
6. Manage subscription lifecycle actions after creation.

API pages used

• Orders & Checkout
• Subscriptions API
• Customers API

Implementation notes

• There is no direct product-flow need to create subscriptions manually.
• One order can create multiple subscriptions when recurring lines have different billing cadences.
• Use order completion as the moment that activates recurring billing.
• Use webhooks or polling to update your application after checkout.

For the billing model, see Subscriptions Overview.