Subscription Status Reference

Paddle maintains a consistent set of subscription statuses to allow you to build specific workflows surrounding how subscription users enter and exit each of the statuses.

Subscription Statuses

With subscription API and Webhook/ Event calls, we send a status field that indicates the current subscription status of a user. Below you’ll find a reference of these possible statuses and how to deal with each of them.

Possible Statuses

Status Description
active Indicates an active subscription, payments are up-to-date. You should give the user full access to their chosen plan.
trialing Indicates the user is in a ‘trial’ state. Dependant on how you’re using trials, you should treat the user differently. The state will change to active once the users first recurring payment is successfully completed.
past_due Indicates we have tried a payment for this user and it has failed, we are retrying the payment according to your retry rules. After a few more payment attempts this will either change to active or deleted dependant on your preferences. You should decide how your wish to treat users in this state.
deleted Indicates that this subscription has been cancelled. You should treat this user as ‘cancelled’ unless they re-subscribe.