Skip to main content

Subscription States

In a nutshell

Subscription status tells you whether a subscription is billable, paused, or ended.

Statuses

StatusMeaning
activeSubscription is active and eligible for billing. Trial subscriptions also use active with trial date fields.
pausedBilling is paused, usually because payment failed or the payment source could not be used.
canceledSubscription has been canceled.
expiredSubscription has expired.
attentionSubscription needs merchant or customer action.

Common transition

active -> paused
A failed invoice payment pauses the subscription.

Trial behavior

Trials are represented with trialStartDate and trialEndDate. There is no separate public trialing status in the current API shape.