Breaking changes

The billing_reason of the first invoice of a subscription is now subscription_create Breaking changes

What’s new

The billing_reason attribute of the Invoice object can now take the value of subscription_create, indicating that it’s the first invoice of a subscription. For older API versions, billing_reason=subscription_create is represented as subscription_update.

Impact

This change introduces a new value, subscription_create, for the billing_reason attribute of Invoice objects, specifically identifying first-time subscription invoices. You can now distinguish between initial subscription invoices and regular updates, enabling more precise tracking and reporting of subscription lifecycles.

Upgrade

1. View your current API version in Workbench.
2. If you use an SDK, upgrade to the corresponding SDK version for this API version.

• If you don’t use an SDK, update your API requests to include Stripe-Version: 2018-10-31

3. Upgrade the API version used for webhook endpoints .
4. Test your integration against the new version.
5. If you use Connect, test your Connect integration .

Learn more about Stripe API upgrades.