View Source Plausible.Billing.Subscription (Plausible v0.0.1)
The subscription statuses are stored in Paddle. They can only be changed through Paddle webhooks, which always send the current subscription status via the payload.
active- All good with the payments. Can access stats.past_due- The payment has failed, but we're trying to charge the customer again. Access to stats is still granted. There will be three retries - after 3, 5, and 7 days have passed from the first failure. After a failure on the final retry, the subscription status will change topaused. As soon as the customer updates their billing details, Paddle will charge them again, and after a successful payment, the subscription will becomeactiveagain.paused- we've tried to charge the customer but all the retries have failed. Stats access restricted. As soon as the customer updates their billing details, Paddle will charge them again, and after a successful payment, the subscription will becomeactiveagain.deleted- The customer has triggered the cancel subscription action. Access to stats should be granted for the time the customer has already paid for. If they want to upgrade again, new billing details have to be provided.
Paddle documentation links for reference:
Subscription statuses - https://developer.paddle.com/classic/reference/zg9joji1mzu0mdi2-subscription-status-reference
Payment failures - https://developer.paddle.com/classic/guides/zg9joji1mzu0mduy-payment-failures
Summary
Types
@type t() :: %Plausible.Billing.Subscription{ __meta__: term(), cancel_url: term(), currency_code: term(), id: term(), inserted_at: term(), last_bill_date: term(), next_bill_amount: term(), next_bill_date: term(), paddle_plan_id: term(), paddle_subscription_id: term(), status: term(), update_url: term(), updated_at: term(), user: term(), user_id: term() }