ringo

[gentle leaf]

Hi there!

You can directly check the Subscriptions status, it should not be active. https://stripe.com/docs/billing/subscriptions/overview#subscription-statuses

Maybe the status you are looking for is incomplete?

[somber verge]

Thanks - I know a new subscription that hasn't yet got a payment method will have a incomplete status, but what if it's an active subscription who's next payment attempt fails? Is the subscription still active?

Basically I'm trying to figure out when I need to alert a user to the fact they need to enter new payment details for a subscription they already have.

[gentle leaf]

In this case the subscription status would be past_due. To be notified of this you could listen to webhook events, like customer.subscriptions.updated. Also note that we have many settings in the dashboard to manage this https://dashboard.stripe.com/settings/billing/automatic

You can learn more about subscriptions webhook events here: https://stripe.com/docs/billing/subscriptions/overview#subscription-events

[somber verge]

Thanks - I'm already listening to webhooks. I'm just trying to get a clear understanding on how to distinguish between different situations. It's a chicken an egg thing - I until I have a customer in this situation I can't be sure what the webhook is going to look like

Is this approx correct:

incomplete - payment method not yet set up
past_due - problem taking payment

[gentle leaf]

It's a chicken an egg thing - I until I have a customer in this situation I can't be sure what the webhook is going to look like
You can test multiple scenarios with test clocks: https://stripe.com/docs/billing/testing/test-clocks

incomplete - payment method not yet set up
past_due - problem taking payment
Yes, correct! This is covered in more details here: https://stripe.com/docs/billing/subscriptions/overview