subscription-use-cases icon indicating copy to clipboard operation
subscription-use-cases copied to clipboard

Published 20 hours ago • verified publisher icon stripe-samples

Ambiguity with regards to proration

Open silviogutierrez opened this issue 4 years ago • 4 comments

Bug report

Describe the bug

The docs have some ambiguity as far as how to prorate per-seat licensing.

To Reproduce

Steps to reproduce the behavior, please provide code snippets or a repository:

  1. Go to https://stripe.com/docs/billing/subscriptions/per-seat#change-price
  2. Note the example has you manually create an invoice then pay it immediately.
  3. And yet, there's also an entire set of proration_behavior options.

Ambiguities

  • Why does this example manually create an invoice and bill it?
  • What's the difference between doing that and instead just passing proration_behavior into the Subscription.modify command?
  • If the example can be simplified by using proration_behavior, then what's the right value to use to mirror the documented example?
  • When you go on the Stripe dashboard itself and manually increase/decrease per-seat quantities, what's the behavior being applied behind the scenes? Basically, what value is used for proration_behavior there?

Thanks guys. Great docs, just some ambiguity.

silviogutierrez avatar Jul 12 '20 18:07 silviogutierrez

@silviogutierrez - thanks for the feedback, you're absolutely right that we should clarify this ambiguity in the guide and the repo. We don't have a PR ready yet but will be working on something, stay tuned!

dawn-stripe avatar Jul 13 '20 20:07 dawn-stripe

Thanks @dawn-stripe . I look forward to the updates.

Do note I filed another issue (#29) related to the same documentation

silviogutierrez avatar Jul 13 '20 23:07 silviogutierrez

Any updates on this?

sandinmyjoints avatar Apr 23 '24 16:04 sandinmyjoints

Hello, This issue seems to be not a sample of this repository, but rather feedback related to Stripe Docs. In the past four years, the content and sample code in Stripe Docs have been renewed.A page related to proration has also been added, so please check it out. https://docs.stripe.com/billing/subscriptions/prorations

Additionally, feedback regarding Stripe Docs can be submitted through the "Was this page helpful?" section located at the bottom of the page. You can directly send feedback to the Document team, so please make use of it. スクリーンショット 2024-04-25 17 02 19

Best,

hideokamoto-stripe avatar Apr 25 '24 08:04 hideokamoto-stripe