lucascheles

[kindred mica]

When canceling a subscription at the end of the period, a final invoice includes any usage reported before the subscription ends. Canceling a subscription immediately doesn’t bill for any usage accrued during the final billing cycle.
https://stripe.com/docs/products-prices/pricing-models#:~:text=When canceling a subscription at the end of the period%2C a final invoice includes any usage reported before the subscription ends. Canceling a subscription immediately doesn’t bill for any usage accrued during the final billing cycle.

[cold briar]

I've tested that using Tests Clocks. I've noticed that when the customer goes to the customer portal and cancels his subscriptions, he is charged 1 or 2 hours later. Seems to me that his behavior is different than what the documentation says. Could this behavior be the result of some kind of setting on my account?

[kindred mica]

Can you share an example sub_xxx

[cold briar]

sub_1MhX8mJS2eq6Ic9KvWhH98eO

[kindred mica]

Checking now

[cold briar]

ok

[kindred mica]

Ok, was set to cancel here: https://dashboard.stripe.com/test/logs/req_wXbfdL1c9S4EiQ
When immediately generated this invoice to reflect usage at the time: https://dashboard.stripe.com/test/invoices/in_1MhXBNJS2eq6Ic9KYWr1PG0F
Which was then paid ~2 minutes later: https://dashboard.stripe.com/test/payments/pi_3MhXC4JS2eq6Ic9K0IRy0kqa

[cold briar]

Then, which behavior is correct? Is it the one described in the documentation or the one that I've seen on my account?

[kindred mica]

Well, it's not 1-2 hours later like you described

The difference is that example was set to cancel immediately. The docs makes reference to if the sub was set to cancel at the end of the current period: https://stripe.com/docs/api/subscriptions/update#update_subscription-cancel_at_period_end

So both are correct, really. Whichever you implement is just down to your preference.

[cold briar]

But what this text from the documentation mean:
"Canceling a subscription immediately doesn’t bill for any usage accrued during the final billing cycle."

Seems to me that the documentation is saying that if the subscription is immediately canceled, then the outstanding amount that the user would pay at the end of the billing period won't be charged.

[kindred mica]

Where is that from sorry?

[cold briar]

https://stripe.com/docs/products-prices/pricing-models#:~:text=When canceling a subscription at the end of the period%2C a final invoice includes any usage reported before the subscription ends. Canceling a subscription immediately doesn’t bill for any usage accrued during the final billing cycle

[cold briar]

Is the documentation correct?

[surreal shoal]

Hey! Taking over for my colleague. Let me catch up.

[cold briar]

ok

[surreal shoal]

AFAIk, canceling a subscription with some usage recorded then they'll be billed. But I agree with you that part is indicating the opposit.

Can you reach out to Support Please at https://support.stripe.com/contact as this isn't a technical integration question rather than product question. You'll get further insights about this.

[cold briar]

ok thank you!