Subscription States
In a nutshell
Subscription status tells you whether a subscription is billable, paused, or ended.Statuses
| Status | Meaning |
|---|---|
active | Subscription is active and eligible for billing. Trial subscriptions also use active with trial date fields. |
paused | Billing is paused, usually because payment failed or the payment source could not be used. |
canceled | Subscription has been canceled. |
expired | Subscription has expired. |
attention | Subscription needs merchant or customer action. |
Common transition
Trial behavior
Trials are represented withtrialStartDate and trialEndDate. There is no separate public trialing status in the current API shape.