Subscription Statuses
Incomplete
This status occurs when a subscription is first created, but the initial payment is pending. It usually happens when the subscription requires a payment method and the customer hasn’t yet provided one or the payment failed.
Incomplete_expired
This status is the state a subscription reaches when the initial payment to start the subscription fails. In that case, the subscription first goes into the incomplete
state. If the payment isn’t completed within 24 hours, the subscription moves to the incomplete_expired
state.
Trialing
If a subscription includes a trial period, it will be in the trialing status until the trial ends.
Active
A subscription is considered active when it is successfully processing payments and the customer has access to the service or product.
Past_due
This status indicates that a payment for the subscription is overdue. This usually happens when the automatic payment fails and hasn’t been recovered.
Canceled
A subscription is marked as canceled when it has been explicitly canceled by the user or the business.
Unpaid
Similar to canceled, but unpaid may keep the invoices open and attempt payments again with a new payment method.
Completed
Is the state that a subscription reaches when it has a finish date