Invoice object 'billing_reason' possible values

[dan...@onxmaps.com]

I'm looking to differentiate first time `invoice.payment_succeeded` events from subscription renewal events and I've noticed that the values for `billing_reason` in the invoice object are different. Can we rely on that data for this purpose and can I get a list of other possible values for that property? There isn't much in the way of documentation there.

Thanks

This e-mail message may contain confidential or legally privileged information and is intended only for the use of the intended recipient(s). onX is not responsible for errors or omissions in this message and denies any responsibility for any damage arising from the use of e-mail. Any opinion and other statement contained in this message and any attachment are solely those of the author and do not necessarily represent those of the company.

[Remi J.]

Hey Daniel,

This property would not work for your current usage, at least not reliably. It's here to explain what caused an invoice to be created and whether it's associated to a subscription update, for example changing the billing cycle, or if it's not subscription related too. We do like the idea of using that property in the future to indicate if the invoice is due to a new subscription or a renewal so we're going to look into it in the future.

For now, the best solution is to look at whether there are more than one invoice associated with that specific subscription using the List Invoices API: https://stripe.com/docs/api#list_invoices

Hope this helps!

Remi

--
You received this message because you are subscribed to the Google Groups "Stripe API Discussion" group.
To unsubscribe from this group and stop receiving emails from it, send an email to api-discuss+unsubscribe@lists.stripe.com.
To post to this group, send email to api-d...@lists.stripe.com.
Visit this group at https://groups.google.com/a/lists.stripe.com/group/api-discuss/.