zell_subscription-questions

[fallen token]

👋 Welcome to your new thread!

⏲️ We'll be here soon! Typically we respond in a few minutes, but sometimes we might take a bit longer if the server is busy or if you have a particularly tricky question.

⏱️ We close idle threads, which makes them read-only. Once a thread is closed it won't be reopened, but you can always start a new thread if you have another question.

🔗 This thread will always be available, even after it's closed. You can find it again using Discord's search, or you can save this link: https://discord.com/channels/841573134531821608/1263185819229884496

📝 Have more to share? Add more details, code, screenshots, videos, etc. below.

[unkempt pebble]

Below are links to other discussions we've had with you in the past week in case you want to review that information. If your question is related to one of these previous discussions, please provide a comprehensive summary of the current state and what you need help with now. We help many users simultaneously, so a summary allows us to resolve your issue as soon as possible.

• zell-liew_api, 6 hours ago, 12 messages

[chrome tinsel]

@latent token hello! Do you have a bit more context on your ask? Are you talking about our Billing product and using a Subscription that for example charges a Customer automatically each month?

[latent token]

Second one — I'm creating a Subscription payment through a Stripe Checkout.

One further question: When the second charge succeeds, will a customer.subscription.updated event be sent?

I'm basically looking for the right event to use.

[chrome tinsel]

Gotcha, then yes a new Invoice will be created each month and all the relevant Events will go with it. I recommend reading https://docs.stripe.com/billing/subscriptions/webhooks to understand what each Event means and find the one you care about the most

[latent token]

Will customer.subscription.updated run as well after the charge?

[chrome tinsel]

yes and no, it depends on what happens to the Subscription. The doc does cover this in detail though

[latent token]

I've already checked the docs but I can't find that information — that's why I'm asking.

[chrome tinsel]

The docs do say

customer.subscription.updated Sent when a subscription starts or changes. For example, renewing a subscription, adding a coupon, applying a discount, adding an invoice item, and changing plans all trigger this event.
So you will get that Event after each new cycle because a new cycle starts so the Subscription current_period_start and current_period_end will change for example. You also get it after the first failed payment because the status becomes past_due
But no you don't get that Event exactly after the next payment. For that you should use invoice.paid

[latent token]

Got it. Thank you very much.

One more question — when subscribers default on payments for a couple of times, do their status change to cancelled automatically?

Or does the subscription get deleted?

OR both?

[chrome tinsel]

https://docs.stripe.com/billing/subscriptions/overview#settings

sorry it's all in our docs. I know it's a lot of content to read but it's important for you to go through it end to end first

zell_subscription-questions

[latent token]

customer.subscription.deleted — Sent when a customer’s subscription ends.

What defines the ending of this subscription?

[chrome tinsel]

It means you/something canceled the Subscription (which is also covered in that doc I just linked you to)

[latent token]

So then my question about whether customers defaulting on their subscription... will than become cancelled... remains unanswered...?

Because I actually did read through the docs before I come into discord to ask.

If payment recovery fails, you can set the subscription status to canceled, unpaid, or leave it past_due.

So does this mean Stripe doesn't cancel the subscription automatically?

[chrome tinsel]

You pick what you want us to do in your account settings. The default is to cancel after all retry attempts have failed