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.
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.
||Indicates an active subscription, payments are up-to-date. You should give the user full access to their chosen plan.|
||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.|
||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
||Indicates that this subscription has been cancelled. You should treat this user as ‘cancelled’ unless they re-subscribe.|