#mentjim-invoicing
fierce lintel
Hi, I don't have a specific invoice ID
I'm more interested in the logic, what makes an invoice have the billing_reason "subscription_update"
wild meadow
I see, it's explained in the API reference https://stripe.com/docs/api/invoices/object#invoice_object-billing_reason
fierce lintel
I 've read that but it's not clear to me I'm afraid
So I understand that subscription_cycle is the billing reasons for invoices that are created because the subscription is renewed
Is the subscription_update reason appended to all invoices that are triggered because of a plan-change, upsell or similar? Are there other cases? Does it always have to be an update that has triggered an new invoice/amount to be paid?
wild meadow
I don't think a new invoice would trigger subscription_update, it's usually for events like customer change the plan (upgrade or download) or change payment settings.
Technically a successful update API call https://stripe.com/docs/api/subscriptions/update would trigger this event
fierce lintel
The invoice object has an attribute billing_reason (which can have the value subscription_update). When do you think such invoices are created?
invoices with it's billing_reason attribute being subscription_update
wild meadow
I wasn't clear in my previous answer. So the invoice with billing_reason=subscription_update is created when the related subscription is updated.
fierce lintel
Ok, and only on subscription updates that actually triggers an new invoice right?
Like upgrading plan, adding licenses, extending/changing billing cycle etc etc. Are there more subscription update calls reasons than those 3 listed above that can trigger a new invoice to be created with that billing reason?
wild meadow
There's a lot params in the Subscription Update API https://stripe.com/docs/api/subscriptions/update so I won't see it's limited to that 3 scenarios.