Public preview
Adds the ability to migrate subscriptions to flexible billing mode Public preview
What’s new
The new method on the Subscription resource, /v1/subscriptions/:subscription/migrate, lets you migrate the billing_mode for existing subscriptions from classic to flexible. You can use the billing mode to control the calculation and orchestration of prorations and invoices for subscriptions.
You can also track the timestamp of your migration with the new billing_mode_details.updated_at field on the Subscription object.
Impact
To migrate the billing_mode of your existing subscriptions, pass in billing_mode: flexible when you make the migrate request.
Learn more about how the billing mode enables flexible behavior for subscriptions and the limitations.
Changes
| Endpoint | Change | Resource |
|---|---|---|
| migrate | Added | Subscription |
| Parameter | Change | Resources or endpoints |
| billing_mode_details | Added | Subscription |
Upgrade
- View your current API version in Workbench.
- 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: 2025-05-28. preview
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
- In Workbench, perform the upgrade . You can roll back the version for 72 hours.
Learn more about Stripe API upgrades.