Makes flexible billing mode the default for new subscriptionsBreaking changes

What’s new

Newly created subscriptions now default to flexible billing mode. You can continue to use classic using the billing_mode.type parameter.

Why is this a breaking change?

Flexible billing mode has several differences over classic that change how subscriptions behave and how they calculate invoices.

Impact

Flexible billing mode provides accurate and predictable billing behavior and additional features for managing subscriptions.

The new default billing mode impacts these integrations:

• Create a subscription
• Create an invoice preview
• Create a subscription schedule
• Create a quote
• Subscriptions created through the Checkout Session API
• Subscriptions created through the Payment Link API

Upgrade