#daisdead
1 messages · Page 1 of 1 (latest)
Hmm I'm not fully understanding the scenario you're describing. Can you share a couple of example requests and the core line items in the response data?
Let me see if I can pull up some request IDs
- a line for the added product and
- a proration line for adding that product in my subscription.
I'd expect a prorated credit for the previous price and a prorated debit for the new one
Here's 2 example request IDs:
req_nUJgN3m1jAnkPQreq_ytkSguXkb1olXu
To clarify imagining the invoice we're previewing is the renewal invoice of a given subscription so I'd expect these lines
- A line for the product added at full price (for payment during the upcoming period)
- A proration line for this current period's partial usage
The issue I'm describing with scheduled updates is that I'm only seeing the line for proration when I'm expecting (unless misunderstanding) that I would see the line for the renewal with the added product included
In the req_nUJgN3m1jAnkPQ example you're removing one item and adding two
in the req_ytkSguXkb1olXu example you're modifying one item and adding one
the common product i'm adding in both of those requests is the primary concern FWIW
common being the "AI" product if youre able to see that detail
Ok, and when you make these requests, whats the output you get?
Is the for the first case?
Yes, looks like a proration credit for the first item thats being deleted, then the full amount for the other two items
Oh is it the case that since i'm in the middle of my subscription period, the reason I don't see the full product line is because there isn't any renewal occurring?
And for our requirements, annual subscriptions have pending invoice item interval of 1 month
What do you mean by this?
That we want to create prorations for any updates to the subscription but specifically for annual subscriptions (our requirements), we invoice prorations aka pending invoice items on a monthly cadence
ah
And since we're calling retrieveUpcoming - the upcoming invoice here doesn't represent renewal but only the prorations
hence missing product line that i am expecting
The one where you switch from annual to monthly is implicitly resetting the billing cycle, so the new monthly items are not prorated
This reset is required when the interval changes
For the other example you're adding another yearly item, so the interval is not changing, and there's a proration item created for the new item
and the upcoming invoice would then bill for both that pending prorated amount and the new full amount
Yeah, what you're describing makes sense. I think I may just need to spend more time understanding the operation I'm performing and the context of the current subscription 🤔
This may have been an bad-use case for this API but we've currently implmented leveraging this endpoint as a "preview your invoicing changes" as if we're on a cart viewing changes
So before the customer actually committed to making the changes as arguments are configured
Gotcha -- I think the main thing to be aware of is that when billing intervals change, you end up with immediate payment, where the default is prorated items that are paid at renewal
https://stripe.com/docs/billing/subscriptions/upgrade-downgrade#immediate-payment
You can force immediate payment with changes, if you want, but that's why you're seeing two pretty different results in the cases you shared
Heard - this has all been useful; appreciate it! 