Subscriptions

A subscription connects a customer to a product and drives renewal invoicing.

Lifecycle

1. Created via checkout, API (POST /v1/subscriptions), or dashboard
2. Active - renewals generate invoices on schedule
3. Past due - payment failed; dunning runs on the open invoice
4. Canceled - immediately or at period end

Cancellation

Use the dashboard or POST /v1/subscriptions/:id/cancel with optional atPeriodEnd: true to cancel at the end of the current period.

Webhooks

subscription.created, subscription.updated, subscription.canceled, subscription.renewed, subscription.payment_succeeded, and subscription.payment_failed keep your app in sync.

API

• POST /v1/subscriptions
• GET /v1/subscriptions/:id
• POST /v1/subscriptions/:id/cancel

See API: Subscriptions.