Subscription Status

A subscription can have different statuses depending on its lifecycle stage, payment status, and user actions. Each status determines whether the subscription can be used, resumed, or requires further action.

INACTIVE

An inactive subscription is a subscription that has not been completed yet.

This status usually occurs when:

• The user has started the checkout process but has not completed it.
• The payment process has not been successfully completed.
• The subscription setup is still pending.

Users can retry the checkout process or complete the payment to activate the subscription.

ACTIVE

An active subscription is a fully created subscription that is currently available for use.

An active subscription means:

• The payment has been successfully completed.
• The subscription is enabled.
• The user can access the subscribed service.

The subscription will continue until it is cancelled, expires, or moves to another status due to payment issues.

CANCELLED

A cancelled subscription is a subscription that has been manually cancelled.

This can happen when:

• The user cancels their subscription.
• The subscription is terminated by an administrator.

Cancelled subscriptions cannot be reactivated. Users must create a new subscription if they want to use the service again.

EXPIRED

An expired subscription is a subscription that has reached the end of its subscription period.

This can happen when:

• The subscription term has ended.
• The subscription was not renewed before the expiration date.

Expired subscriptions cannot be reactivated. A new subscription must be created to continue using the service.

PASTDUE

A pastdue subscription is a subscription with an outstanding payment that was not completed by the payment due date.

This can happen when:

• A payment attempt fails.
• The payment method is declined.
• The customer does not complete the required payment.

To resolve a pastdue subscription:

1. Check and update the payment method if required.
2. Complete the outstanding payment.
3. Once payment is successful, the subscription can be restored to an active state.

PAUSED

A paused subscription is a subscription that has been temporarily suspended and is not currently active.

This status is used when:

• The subscription should remain available for future continuation.
• Billing or service access needs to be temporarily stopped.
• The subscription requires manual review or temporary suspension.

A paused subscription is different from a cancelled subscription because it can be resumed later.

To reactivate a paused subscription:

1. Confirm the subscription is eligible for resumption.
2. Resolve any required payment or account issues.
3. Resume the subscription to make it active again.