Breaking changes
Replaces Upcoming Invoice API methods with the Create Preview Invoice API Breaking changes
What’s new
We’re removing the GET /the relevant part of the product API in favor of the Create Preview Invoice API.
Additionally, you can no longer preview the next invoice for a customer across all their subscriptions on the Create Preview Invoice API.
Why is this a breaking change?
- The Upcoming Invoice API methods are no longer available.
- You must pass specific subscription details ( subscription , subscription _ details. items , schedule , schedule _ details. phases , or invoice _ items ) along with the customer parameter to the Create Preview Invoice API .
Impact
Migrate your integration from GET /the relevant part of the product or GET /the relevant part of the product API methods to use the Create Preview Invoice API, which offers equivalent functionality and parameters.
Changes
| Endpoints | Change | Resource |
|---|---|---|
| upcomingLines upcoming | Removed | Invoice |
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-03-31. basil
- 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.