renee_subscription-event | Stripe Developers | Page 1

bright depotBOT Sep 19, 2024, 3:44 PM

#

👋 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/1286352141749059634

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

#

waxen harness Sep 19, 2024, 3:44 PM

#

@wanton gazelle I recommend reading https://docs.stripe.com/billing/subscriptions/webhooks to better understand how it works.

#

renee_subscription-event

wanton gazelle Sep 19, 2024, 4:02 PM

#

I see for this we can use subscription_schedule.canceled as this canceles any active associated subscription, would this be true for subscriptions that move from past-due to unpaid as well?

waxen harness Sep 19, 2024, 4:05 PM

#

for this we can use subscription_schedule.canceled as this canceles any active associated subscription
this only works if you are using SubscriptionSchedules already. If you aren't, it's irrelevant

would this be true for subscriptions that move from past-due to unpaid as well?
No, in that case the Subscription is not canceled. I recommend never using unpaid honestly personally. But if you do then you have to look at customer.subscription.updated and check the Subscription's status (and what it was before in previous_attributes)

wanton gazelle Sep 19, 2024, 4:09 PM

#

how does subscription_schedule.canceled differ from customer.subscription.deleted? Is this just difference of when sub was canceled at vs. when actually deactived?

wanton gazelle Sep 19, 2024, 4:10 PM

#

waxen harness > for this we can use subscription_schedule.canceled as this canceles any active...

Why do you recommend never using unpaid?

waxen harness Sep 19, 2024, 4:13 PM

#

Subscription and SubscriptionSchedules are different APIs, each with their own Events. See https://stripe.com/docs/billing/subscriptions/subscription-schedules for more details.

#

And because unpaid is just a bad idea, you end up with Subscription that renew forever, that you never clean up, it hurts your metrics, etc. It's uncommon to use this unless you're the type of business that plans to get their funds back even months later. For example a phone company or an electricity company. They keep issuing Invoices over a certain period even if you don't pay, keep giving you the service and have ways to require you to pay what you owe
Most businesses are unlikely to want that

wanton gazelle Sep 19, 2024, 4:15 PM

#

Okay, thank you for that. That makes sense.

#

One more question for you.... I am trying to break down the Subscription customer churn report that is in Reporting Revenue Reports and trying to follow the events there to how Stripe is reporting on involuntary churn. Any idea what they are using to query for that report?

#renee_subscription-event