Adds the trial property to subscription schedule phases
What’s new
Adds the trial boolean property to the phase configuration of the Subscription Schedule object. This property indicates whether a phase is configured as a full trial, meaning the customer isn’t charged during that phase.
Previously, passing trial=true and trial_end together when updating a Subscription Schedule returned an error because the two parameters were treated as mutually exclusive. You can now pass both parameters together when updating a Subscription Schedule, provided that the value of trial_end matches the phase’s end date.
Impact
If your integration reads a Subscription Schedule object and writes it back to the API in a round-trip pattern, you can now include the trial property without removing trial_end. For details about how phases define scheduled subscription changes, see Subscription schedule phases. If you have an existing integration, you don’t need to make any changes.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| trial | Added | SubscriptionSchedule. phases[] |
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-07-29. dahlia
- 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.