Public preview

Adds configurable trial offers for subscription items Public preview

What’s new

Adds the ability to create and manage trial offers for subscription items using the new Trial Offers API. You can specify a price to use during the trial and a price to use after the trial. You can also define a Trial Offer’s duration by setting an ending timestamp or by specifying a number of price intervals.

Adds the ability to assign a Trial Offer to a Subscription Item and, if applicable, specify a trial ending timestamp on the Subscription Item using the new current_trial parameter.

Also adds the ability to control whether a subscription’s billing cycle anchor resets at the end of a trial period by setting the new trial_settings.end_behavior.billing_cycle_anchor parameter.

Changes

	Change	Resource
	Added	ProductCatalog. TrialOffer
Endpoint	Change	Resource
create	Added	ProductCatalog. TrialOffer
Parameters	Change	Resources or endpoints
trial_offer	Added	Invoice#create_preview. schedule_details. amendments[]. item_actions[]. add Invoice#create_preview. schedule_details. amendments[]. item_actions[]. set Invoice#create_preview. schedule_details. phases[]. items[] + 12 more Quote#create. lines[]. actions[]. add_item Quote#create. lines[]. actions[]. set_items[] Quote#update. lines[]. actions[]. add_item Quote#update. lines[]. actions[]. set_items[] QuoteLine. actions[]. add_item QuoteLine. actions[]. set_items[] `QuotePreviewSubscriptionSchedule.phases[].items[]` SubscriptionSchedule#amend. amendments[]. item_actions[]. add SubscriptionSchedule#amend. amendments[]. item_actions[]. set SubscriptionSchedule#create. phases[]. items[] SubscriptionSchedule#update. phases[]. items[] SubscriptionSchedule. phases[]. items[]
current_trial	Added	Invoice#create_preview. subscription_details. items[] Subscription#create. items[] Subscription#update. items[] + 3 more SubscriptionItem SubscriptionItem#create SubscriptionItem#update
billing_cycle_anchor	Added	Subscription#create. trial_settings. end_behavior Subscription#update. trial_settings. end_behavior Subscription. trial_settings. end_behavior

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-03-25. 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.