Subscription statuses
The six values a subscription's status can take. This is the single source for them — the Subscriptions endpoint, the subscription.status_changed event and the SDK all draw from this set.
| Status | Meaning |
|---|---|
pending_checkout | Newly created; the buyer hasn't completed checkout/payment yet. |
active | Currently active subscription. |
due | next_billing_cycle has passed but no payment has been received yet. |
cancelled | Cancellation has taken effect — the billing period ended and the subscription is over. |
pending_cancellation | Scheduled to cancel — it stays active until the end of the current billing cycle, then cancels. |
inactive | Automatically ended after the grace period elapsed without payment. |
Transitions worth handling separately
subscription.status_changed names both the old and the new status, and the pair usually matters more than the destination:
| From → to | What it means |
|---|---|
pending_checkout → active | First activation — the buyer just paid for the first time. |
inactive → active | Reactivation of a lapsed subscription. |
active → due | A renewal came round and payment has not arrived yet. |
due → inactive | The grace period elapsed without payment. |
active → pending_cancellation | Cancellation scheduled for the end of the cycle. The subscription stays usable until then. |
pending_cancellation → active | A scheduled cancellation was undone — see Resume. |
pending_cancellation → cancelled | The period ended and the cancellation took effect. |
A status change is not a payment. Reaching
active does not by itself mean money arrived — checkout.succeeded is the event that says that.