- Breaking changes
- Public preview
Includes deleted prices in trial offer price data Breaking changes Public preview
What’s new
Expands the Trial Offer object’s price property and end_behavior.transition.price property to return a deleted Price object when the referenced Price has been deleted. Previously, expanding either property when its referenced Price was deleted returned an error. When expanded, the property can now return a Price object with deleted set to true.
Why is this a breaking change?
The price property on the Trial Offer object previously always returned a full Price object when expanded. It can now return a deleted Price object with deleted set to true. If your code assumes the expanded value is always a full Price object, you must update it to handle a deleted price.
Impact
You can now view deleted price values when you expand the price property on a Trial Offer. Previously, expanding the price property on a Trial Offer with a deleted price returned an error. Update your integration to handle the case where the returned price has deleted set to true.
Changes
| Fields | Change | From → to |
|---|---|---|
| ProductCatalog. TrialOffer. end_behavior. transition. price ProductCatalog. TrialOffer. price | Changed | $Price → deletable($Price) |
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: 2026-08-26. 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.