# Adds configurable trial offers for subscription items ## What’s new Adds the ability to create and manage trial offers for subscription items using the new [Trial Offers](https://docs.stripe.com/api/product-catalog/trial-offer.md?api-version=2026-03-25.preview) API. You can specify a [price](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-03-25.preview#product_catalog_trial_offer_object-price) to use during the trial and a price to use after the trial. You can also define a Trial Offer’s [duration](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-03-25.preview#product_catalog_trial_offer_object-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](https://docs.stripe.com/api/subscription_items/create.md?api-version=2026-03-25.preview#create_subscription_item-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](https://docs.stripe.com/api/subscriptions/create.md?api-version=2026-03-25.preview#create_subscription-trial_settings-end_behavior-billing_cycle_anchor) parameter. ## Changes #### REST API | | Change | Resource | | | ------ | --------------------------------------------------------------------------------------------------- | | | Added | [ProductCatalog.TrialOffer](/api/product-catalog/trial-offer/object?api-version=2026-03-25.preview) | | Endpoint | Change | Resource | | -------- | ------ | --------------------------------------------------------------------------------------------------- | | `create` | Added | [ProductCatalog.TrialOffer](/api/product-catalog/trial-offer/object?api-version=2026-03-25.preview) | | Parameters | Change | Resources or endpoints | | ---------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `trial_offer` | Added | [Invoice#create_preview.schedule_details.amendments[].item_actions[].add](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-amendments-item_actions-add), [Invoice#create_preview.schedule_details.amendments[].item_actions[].set](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-amendments-item_actions-set), [Invoice#create_preview.schedule_details.phases[].items[]](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-phases-items), [Quote#create.lines[].actions[].add_item](/api/quotes/create?api-version=2026-03-25.preview#create_quote-lines-actions-add_item), [Quote#create.lines[].actions[].set_items[]](/api/quotes/create?api-version=2026-03-25.preview#create_quote-lines-actions-set_items), [Quote#update.lines[].actions[].add_item](/api/quotes/update?api-version=2026-03-25.preview#update_quote-lines-actions-add_item), [Quote#update.lines[].actions[].set_items[]](/api/quotes/update?api-version=2026-03-25.preview#update_quote-lines-actions-set_items), [QuoteLine.actions[].add_item](/api/quote_lines/object?api-version=2026-03-25.preview#quote_line_object-actions-add_item), [QuoteLine.actions[].set_items[]](/api/quote_lines/object?api-version=2026-03-25.preview#quote_line_object-actions-set_items), `QuotePreviewSubscriptionSchedule.phases[].items[]`, [SubscriptionSchedule#amend.amendments[].item_actions[].add](/api/subscription_schedules/amend?api-version=2026-03-25.preview#amend_subscription_schedule-amendments-item_actions-add), [SubscriptionSchedule#amend.amendments[].item_actions[].set](/api/subscription_schedules/amend?api-version=2026-03-25.preview#amend_subscription_schedule-amendments-item_actions-set), [SubscriptionSchedule#create.phases[].items[]](/api/subscription_schedules/create?api-version=2026-03-25.preview#create_subscription_schedule-phases-items), [SubscriptionSchedule#update.phases[].items[]](/api/subscription_schedules/update?api-version=2026-03-25.preview#update_subscription_schedule-phases-items), [SubscriptionSchedule.phases[].items[]](/api/subscription_schedules/object?api-version=2026-03-25.preview#subscription_schedule_object-phases-items) | | `current_trial` | Added | [Invoice#create_preview.subscription_details.items[]](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-subscription_details-items), [Subscription#create.items[]](/api/subscriptions/create?api-version=2026-03-25.preview#create_subscription-items), [Subscription#update.items[]](/api/subscriptions/update?api-version=2026-03-25.preview#update_subscription-items), [SubscriptionItem](/api/subscription_items/object?api-version=2026-03-25.preview), [SubscriptionItem#create](/api/subscription_items/create?api-version=2026-03-25.preview), [SubscriptionItem#update](/api/subscription_items/update?api-version=2026-03-25.preview) | | `billing_cycle_anchor` | Added | [Subscription#create.trial_settings.end_behavior](/api/subscriptions/create?api-version=2026-03-25.preview#create_subscription-trial_settings-end_behavior), [Subscription#update.trial_settings.end_behavior](/api/subscriptions/update?api-version=2026-03-25.preview#update_subscription-trial_settings-end_behavior), [Subscription.trial_settings.end_behavior](/api/subscriptions/object?api-version=2026-03-25.preview#subscription_object-trial_settings-end_behavior) | #### Ruby | | Change | Resource | | | ------ | ---------------------------------------------------------------------------------------------------- | | | Added | [ProductCatalog::TrialOffer](/api/product-catalog/trial-offer/object?api-version=2026-03-25.preview) | | Method | Change | Resource | | -------- | ------ | ---------------------------------------------------------------------------------------------------- | | `create` | Added | [ProductCatalog::TrialOffer](/api/product-catalog/trial-offer/object?api-version=2026-03-25.preview) | | Parameters | Change | Resources or methods | | ---------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `trial_offer` | Added | [InvoiceCreatePreviewParams::ScheduleDetail::Amendment::ItemAction::Add](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-amendments-item_actions-add), [InvoiceCreatePreviewParams::ScheduleDetail::Amendment::ItemAction::Set](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-amendments-item_actions-set), [InvoiceCreatePreviewParams::ScheduleDetail::Phase::Item](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-phases-items), [QuoteCreateParams::Line::Action::AddItem](/api/quotes/create?api-version=2026-03-25.preview#create_quote-lines-actions-add_item), [QuoteCreateParams::Line::Action::SetItem](/api/quotes/create?api-version=2026-03-25.preview#create_quote-lines-actions-set_items), [QuoteLine::Action::AddItem](/api/quote_lines/object?api-version=2026-03-25.preview#quote_line_object-actions-add_item), [QuoteLine::Action::SetItem](/api/quote_lines/object?api-version=2026-03-25.preview#quote_line_object-actions-set_items), `QuotePreviewSubscriptionSchedule::Phase::Item`, [QuoteUpdateParams::Line::Action::AddItem](/api/quotes/update?api-version=2026-03-25.preview#update_quote-lines-actions-add_item), [QuoteUpdateParams::Line::Action::SetItem](/api/quotes/update?api-version=2026-03-25.preview#update_quote-lines-actions-set_items), [SubscriptionSchedule::Phase::Item](/api/subscription_schedules/object?api-version=2026-03-25.preview#subscription_schedule_object-phases-items), [SubscriptionScheduleAmendParams::Amendment::ItemAction::Add](/api/subscription_schedules/amend?api-version=2026-03-25.preview#amend_subscription_schedule-amendments-item_actions-add), [SubscriptionScheduleAmendParams::Amendment::ItemAction::Set](/api/subscription_schedules/amend?api-version=2026-03-25.preview#amend_subscription_schedule-amendments-item_actions-set), [SubscriptionScheduleCreateParams::Phase::Item](/api/subscription_schedules/create?api-version=2026-03-25.preview#create_subscription_schedule-phases-items), [SubscriptionScheduleUpdateParams::Phase::Item](/api/subscription_schedules/update?api-version=2026-03-25.preview#update_subscription_schedule-phases-items) | | `current_trial` | Added | [InvoiceCreatePreviewParams::SubscriptionDetail::Item](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-subscription_details-items), [SubscriptionCreateParams::Item](/api/subscriptions/create?api-version=2026-03-25.preview#create_subscription-items), [SubscriptionItem](/api/subscription_items/object?api-version=2026-03-25.preview), [SubscriptionItemCreateParams](/api/subscription_items/create?api-version=2026-03-25.preview), [SubscriptionItemUpdateParams](/api/subscription_items/update?api-version=2026-03-25.preview), [SubscriptionUpdateParams::Item](/api/subscriptions/update?api-version=2026-03-25.preview#update_subscription-items) | | `billing_cycle_anchor` | Added | [Subscription::TrialSetting::EndBehavior](/api/subscriptions/object?api-version=2026-03-25.preview#subscription_object-trial_settings-end_behavior), [SubscriptionCreateParams::TrialSetting::EndBehavior](/api/subscriptions/create?api-version=2026-03-25.preview#create_subscription-trial_settings-end_behavior), [SubscriptionUpdateParams::TrialSetting::EndBehavior](/api/subscriptions/update?api-version=2026-03-25.preview#update_subscription-trial_settings-end_behavior) | #### Python | | Change | Resource | | | ------ | ---------------------------------------------------------------------------------------------------- | | | Added | [product_catalog.TrialOffer](/api/product-catalog/trial-offer/object?api-version=2026-03-25.preview) | | Method | Change | Resource | | -------- | ------ | ---------------------------------------------------------------------------------------------------- | | `create` | Added | [product_catalog.TrialOffer](/api/product-catalog/trial-offer/object?api-version=2026-03-25.preview) | | Parameters | Change | Resources or methods | | ---------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `trial_offer` | Added | [InvoiceCreatePreviewParamsScheduleDetailAmendmentItemActionAdd](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-amendments-item_actions-add), [InvoiceCreatePreviewParamsScheduleDetailAmendmentItemActionSet](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-amendments-item_actions-set), [InvoiceCreatePreviewParamsScheduleDetailPhaseItem](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-phases-items), [QuoteCreateParamsLineActionAddItem](/api/quotes/create?api-version=2026-03-25.preview#create_quote-lines-actions-add_item), [QuoteCreateParamsLineActionSetItem](/api/quotes/create?api-version=2026-03-25.preview#create_quote-lines-actions-set_items), [QuoteLine.Action.AddItem](/api/quote_lines/object?api-version=2026-03-25.preview#quote_line_object-actions-add_item), [QuoteLine.Action.SetItem](/api/quote_lines/object?api-version=2026-03-25.preview#quote_line_object-actions-set_items), [QuoteModifyParamsLineActionAddItem](/api/quotes/update?api-version=2026-03-25.preview#update_quote-lines-actions-add_item), [QuoteModifyParamsLineActionSetItem](/api/quotes/update?api-version=2026-03-25.preview#update_quote-lines-actions-set_items), `QuotePreviewSubscriptionSchedule.Phase.Item`, [SubscriptionSchedule.Phase.Item](/api/subscription_schedules/object?api-version=2026-03-25.preview#subscription_schedule_object-phases-items), [SubscriptionScheduleAmendParamsAmendmentItemActionAdd](/api/subscription_schedules/amend?api-version=2026-03-25.preview#amend_subscription_schedule-amendments-item_actions-add), [SubscriptionScheduleAmendParamsAmendmentItemActionSet](/api/subscription_schedules/amend?api-version=2026-03-25.preview#amend_subscription_schedule-amendments-item_actions-set), [SubscriptionScheduleCreateParamsPhaseItem](/api/subscription_schedules/create?api-version=2026-03-25.preview#create_subscription_schedule-phases-items), [SubscriptionScheduleModifyParamsPhaseItem](/api/subscription_schedules/update?api-version=2026-03-25.preview#update_subscription_schedule-phases-items) | | `current_trial` | Added | [InvoiceCreatePreviewParamsSubscriptionDetailItem](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-subscription_details-items), [SubscriptionCreateParamsItem](/api/subscriptions/create?api-version=2026-03-25.preview#create_subscription-items), [SubscriptionItem](/api/subscription_items/object?api-version=2026-03-25.preview), [SubscriptionItemCreateParams](/api/subscription_items/create?api-version=2026-03-25.preview), [SubscriptionItemModifyParams](/api/subscription_items/update?api-version=2026-03-25.preview), [SubscriptionModifyParamsItem](/api/subscriptions/update?api-version=2026-03-25.preview#update_subscription-items) | | `billing_cycle_anchor` | Added | [Subscription.TrialSetting.EndBehavior](/api/subscriptions/object?api-version=2026-03-25.preview#subscription_object-trial_settings-end_behavior), [SubscriptionCreateParamsTrialSettingEndBehavior](/api/subscriptions/create?api-version=2026-03-25.preview#create_subscription-trial_settings-end_behavior), [SubscriptionModifyParamsTrialSettingEndBehavior](/api/subscriptions/update?api-version=2026-03-25.preview#update_subscription-trial_settings-end_behavior) | #### PHP | | Change | Resource | | | ------ | --------------------------------------------------------------------------------------------------- | | | Added | [ProductCatalog.TrialOffer](/api/product-catalog/trial-offer/object?api-version=2026-03-25.preview) | | Method | Change | Resource | | -------- | ------ | --------------------------------------------------------------------------------------------------- | | `create` | Added | [ProductCatalog.TrialOffer](/api/product-catalog/trial-offer/object?api-version=2026-03-25.preview) | | Parameters | Change | Resources or methods | | ---------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `trial_offer` | Added | [Invoice.create_preview().$params.schedule_detail.amendment.item_action.add](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-amendments-item_actions-add), [Invoice.create_preview().$params.schedule_detail.amendment.item_action.set](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-amendments-item_actions-set), [Invoice.create_preview().$params.schedule_detail.phase.item](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-phases-items), [Quote.create().$params.line.action.add_item](/api/quotes/create?api-version=2026-03-25.preview#create_quote-lines-actions-add_item), [Quote.create().$params.line.action.set_item](/api/quotes/create?api-version=2026-03-25.preview#create_quote-lines-actions-set_items), [Quote.update().$params.line.action.add_item](/api/quotes/update?api-version=2026-03-25.preview#update_quote-lines-actions-add_item), [Quote.update().$params.line.action.set_item](/api/quotes/update?api-version=2026-03-25.preview#update_quote-lines-actions-set_items), [QuoteLine.actions[].add_item](/api/quote_lines/object?api-version=2026-03-25.preview#quote_line_object-actions-add_item), [QuoteLine.actions[].set_items[]](/api/quote_lines/object?api-version=2026-03-25.preview#quote_line_object-actions-set_items), `QuotePreviewSubscriptionSchedule.phases[].items[]`, [SubscriptionSchedule.amend().$params.amendment.item_action.add](/api/subscription_schedules/amend?api-version=2026-03-25.preview#amend_subscription_schedule-amendments-item_actions-add), [SubscriptionSchedule.amend().$params.amendment.item_action.set](/api/subscription_schedules/amend?api-version=2026-03-25.preview#amend_subscription_schedule-amendments-item_actions-set), [SubscriptionSchedule.create().$params.phase.item](/api/subscription_schedules/create?api-version=2026-03-25.preview#create_subscription_schedule-phases-items), [SubscriptionSchedule.phases[].items[]](/api/subscription_schedules/object?api-version=2026-03-25.preview#subscription_schedule_object-phases-items), [SubscriptionSchedule.update().$params.phase.item](/api/subscription_schedules/update?api-version=2026-03-25.preview#update_subscription_schedule-phases-items) | | `current_trial` | Added | [Invoice.create_preview().$params.subscription_detail.item](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-subscription_details-items), [Subscription.create().$params.item](/api/subscriptions/create?api-version=2026-03-25.preview#create_subscription-items), [Subscription.update().$params.item](/api/subscriptions/update?api-version=2026-03-25.preview#update_subscription-items), [SubscriptionItem](/api/subscription_items/object?api-version=2026-03-25.preview), [SubscriptionItem.create().$params](/api/subscription_items/create?api-version=2026-03-25.preview), [SubscriptionItem.update().$params](/api/subscription_items/update?api-version=2026-03-25.preview) | | `billing_cycle_anchor` | Added | [Subscription.create().$params.trial_setting.end_behavior](/api/subscriptions/create?api-version=2026-03-25.preview#create_subscription-trial_settings-end_behavior), [Subscription.trial_settings.end_behavior](/api/subscriptions/object?api-version=2026-03-25.preview#subscription_object-trial_settings-end_behavior), [Subscription.update().$params.trial_setting.end_behavior](/api/subscriptions/update?api-version=2026-03-25.preview#update_subscription-trial_settings-end_behavior) | #### Java | | Change | Resource | | | ------ | --------------------------------------------------------------------------------------------------- | | | Added | [productcatalog.TrialOffer](/api/product-catalog/trial-offer/object?api-version=2026-03-25.preview) | | Method | Change | Resource | | -------- | ------ | --------------------------------------------------------------------------------------------------- | | `create` | Added | [productcatalog.TrialOffer](/api/product-catalog/trial-offer/object?api-version=2026-03-25.preview) | | Parameters | Change | Resources or methods | | -------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `trialOffer` | Added | [InvoiceCreatePreviewParams.schedule_details.amendments[].item_actions[].add](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-amendments-item_actions-add), [InvoiceCreatePreviewParams.schedule_details.amendments[].item_actions[].set](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-amendments-item_actions-set), [InvoiceCreatePreviewParams.schedule_details.phases[].items[]](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-phases-items), [QuoteCreateParams.lines[].actions[].add_item](/api/quotes/create?api-version=2026-03-25.preview#create_quote-lines-actions-add_item), [QuoteCreateParams.lines[].actions[].set_items[]](/api/quotes/create?api-version=2026-03-25.preview#create_quote-lines-actions-set_items), [QuoteLine.actions[].add_item](/api/quote_lines/object?api-version=2026-03-25.preview#quote_line_object-actions-add_item), [QuoteLine.actions[].set_items[]](/api/quote_lines/object?api-version=2026-03-25.preview#quote_line_object-actions-set_items), `QuotePreviewSubscriptionSchedule.phases[].items[]`, [QuoteUpdateParams.lines[].actions[].add_item](/api/quotes/update?api-version=2026-03-25.preview#update_quote-lines-actions-add_item), [QuoteUpdateParams.lines[].actions[].set_items[]](/api/quotes/update?api-version=2026-03-25.preview#update_quote-lines-actions-set_items), [SubscriptionSchedule.phases[].items[]](/api/subscription_schedules/object?api-version=2026-03-25.preview#subscription_schedule_object-phases-items), [SubscriptionScheduleAmendParams.amendments[].item_actions[].add](/api/subscription_schedules/amend?api-version=2026-03-25.preview#amend_subscription_schedule-amendments-item_actions-add), [SubscriptionScheduleAmendParams.amendments[].item_actions[].set](/api/subscription_schedules/amend?api-version=2026-03-25.preview#amend_subscription_schedule-amendments-item_actions-set), [SubscriptionScheduleCreateParams.phases[].items[]](/api/subscription_schedules/create?api-version=2026-03-25.preview#create_subscription_schedule-phases-items), [SubscriptionScheduleUpdateParams.phases[].items[]](/api/subscription_schedules/update?api-version=2026-03-25.preview#update_subscription_schedule-phases-items) | | `currentTrial` | Added | [InvoiceCreatePreviewParams.subscription_details.items[]](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-subscription_details-items), [SubscriptionCreateParams.items[]](/api/subscriptions/create?api-version=2026-03-25.preview#create_subscription-items), [SubscriptionItem](/api/subscription_items/object?api-version=2026-03-25.preview), [SubscriptionItemCreateParams](/api/subscription_items/create?api-version=2026-03-25.preview), [SubscriptionItemUpdateParams](/api/subscription_items/update?api-version=2026-03-25.preview), [SubscriptionUpdateParams.items[]](/api/subscriptions/update?api-version=2026-03-25.preview#update_subscription-items) | | `billingCycleAnchor` | Added | [Subscription.trial_settings.end_behavior](/api/subscriptions/object?api-version=2026-03-25.preview#subscription_object-trial_settings-end_behavior), [SubscriptionCreateParams.trial_settings.end_behavior](/api/subscriptions/create?api-version=2026-03-25.preview#create_subscription-trial_settings-end_behavior), [SubscriptionUpdateParams.trial_settings.end_behavior](/api/subscriptions/update?api-version=2026-03-25.preview#update_subscription-trial_settings-end_behavior) | #### Node.js | | Change | Resource | | | ------ | --------------------------------------------------------------------------------------------------- | | | Added | [ProductCatalog.TrialOffer](/api/product-catalog/trial-offer/object?api-version=2026-03-25.preview) | | Method | Change | Resource | | -------- | ------ | --------------------------------------------------------------------------------------------------- | | `create` | Added | [ProductCatalog.TrialOffer](/api/product-catalog/trial-offer/object?api-version=2026-03-25.preview) | | Parameters | Change | Resources or methods | | ---------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `trial_offer` | Added | [InvoiceCreatePreviewParams.schedule_details.amendments[].item_actions[].add](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-amendments-item_actions-add), [InvoiceCreatePreviewParams.schedule_details.amendments[].item_actions[].set](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-amendments-item_actions-set), [InvoiceCreatePreviewParams.schedule_details.phases[].items[]](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-phases-items), [QuoteCreateParams.lines[].actions[].add_item](/api/quotes/create?api-version=2026-03-25.preview#create_quote-lines-actions-add_item), [QuoteCreateParams.lines[].actions[].set_items[]](/api/quotes/create?api-version=2026-03-25.preview#create_quote-lines-actions-set_items), [QuoteLine.actions[].add_item](/api/quote_lines/object?api-version=2026-03-25.preview#quote_line_object-actions-add_item), [QuoteLine.actions[].set_items[]](/api/quote_lines/object?api-version=2026-03-25.preview#quote_line_object-actions-set_items), `QuotePreviewSubscriptionSchedule.phases[].items[]`, [QuoteUpdateParams.lines[].actions[].add_item](/api/quotes/update?api-version=2026-03-25.preview#update_quote-lines-actions-add_item), [QuoteUpdateParams.lines[].actions[].set_items[]](/api/quotes/update?api-version=2026-03-25.preview#update_quote-lines-actions-set_items), [SubscriptionSchedule.phases[].items[]](/api/subscription_schedules/object?api-version=2026-03-25.preview#subscription_schedule_object-phases-items), [SubscriptionScheduleAmendParams.amendments[].item_actions[].add](/api/subscription_schedules/amend?api-version=2026-03-25.preview#amend_subscription_schedule-amendments-item_actions-add), [SubscriptionScheduleAmendParams.amendments[].item_actions[].set](/api/subscription_schedules/amend?api-version=2026-03-25.preview#amend_subscription_schedule-amendments-item_actions-set), [SubscriptionScheduleCreateParams.phases[].items[]](/api/subscription_schedules/create?api-version=2026-03-25.preview#create_subscription_schedule-phases-items), [SubscriptionScheduleUpdateParams.phases[].items[]](/api/subscription_schedules/update?api-version=2026-03-25.preview#update_subscription_schedule-phases-items) | | `current_trial` | Added | [InvoiceCreatePreviewParams.subscription_details.items[]](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-subscription_details-items), [SubscriptionCreateParams.items[]](/api/subscriptions/create?api-version=2026-03-25.preview#create_subscription-items), [SubscriptionItem](/api/subscription_items/object?api-version=2026-03-25.preview), [SubscriptionItemCreateParams](/api/subscription_items/create?api-version=2026-03-25.preview), [SubscriptionItemUpdateParams](/api/subscription_items/update?api-version=2026-03-25.preview), [SubscriptionUpdateParams.items[]](/api/subscriptions/update?api-version=2026-03-25.preview#update_subscription-items) | | `billing_cycle_anchor` | Added | [Subscription.trial_settings.end_behavior](/api/subscriptions/object?api-version=2026-03-25.preview#subscription_object-trial_settings-end_behavior), [SubscriptionCreateParams.trial_settings.end_behavior](/api/subscriptions/create?api-version=2026-03-25.preview#create_subscription-trial_settings-end_behavior), [SubscriptionUpdateParams.trial_settings.end_behavior](/api/subscriptions/update?api-version=2026-03-25.preview#update_subscription-trial_settings-end_behavior) | #### Go | | Change | Resource | | | ------ | -------------------------------------------------------------------------------------------------- | | | Added | [ProductCatalogTrialOffer](/api/product-catalog/trial-offer/object?api-version=2026-03-25.preview) | | Method | Change | Resource | | ------ | ------ | -------------------------------------------------------------------------------------------------- | | `New` | Added | [ProductCatalogTrialOffer](/api/product-catalog/trial-offer/object?api-version=2026-03-25.preview) | | Parameters | Change | Resources or methods | | -------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `TrialOffer` | Added | [InvoiceCreatePreviewScheduleDetailsAmendmentItemActionAddParams](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-amendments-item_actions-add), [InvoiceCreatePreviewScheduleDetailsAmendmentItemActionSetParams](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-amendments-item_actions-set), [InvoiceCreatePreviewScheduleDetailsPhaseItemParams](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-phases-items), [QuoteLineActionAddItem](/api/quote_lines/object?api-version=2026-03-25.preview#quote_line_object-actions-add_item), [QuoteLineActionAddItemParams](/api/quotes/create?api-version=2026-03-25.preview#create_quote-lines-actions-add_item), [QuoteLineActionSetItemParams](/api/quotes/create?api-version=2026-03-25.preview#create_quote-lines-actions-set_items), [QuoteLineActionSetItems](/api/quote_lines/object?api-version=2026-03-25.preview#quote_line_object-actions-set_items), `QuotePreviewSubscriptionSchedulePhaseItem`, [SubscriptionScheduleAmendAmendmentItemActionAddParams](/api/subscription_schedules/amend?api-version=2026-03-25.preview#amend_subscription_schedule-amendments-item_actions-add), [SubscriptionScheduleAmendAmendmentItemActionSetParams](/api/subscription_schedules/amend?api-version=2026-03-25.preview#amend_subscription_schedule-amendments-item_actions-set), [SubscriptionSchedulePhaseItem](/api/subscription_schedules/object?api-version=2026-03-25.preview#subscription_schedule_object-phases-items), [SubscriptionSchedulePhaseItemParams](/api/subscription_schedules/create?api-version=2026-03-25.preview#create_subscription_schedule-phases-items) | | `CurrentTrial` | Added | [InvoiceCreatePreviewSubscriptionDetailsItemParams](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-subscription_details-items), [SubscriptionItem](/api/subscription_items/object?api-version=2026-03-25.preview), [SubscriptionItemParams](/api/subscription_items/update?api-version=2026-03-25.preview) | | `BillingCycleAnchor` | Added | [SubscriptionTrialSettingsEndBehavior](/api/subscriptions/object?api-version=2026-03-25.preview#subscription_object-trial_settings-end_behavior), [SubscriptionTrialSettingsEndBehaviorParams](/api/subscriptions/update?api-version=2026-03-25.preview#update_subscription-trial_settings-end_behavior) | #### .NET | | Change | Resource | | | ------ | --------------------------------------------------------------------------------------------------- | | | Added | [ProductCatalog.TrialOffer](/api/product-catalog/trial-offer/object?api-version=2026-03-25.preview) | | Method | Change | Resource | | -------- | ------ | --------------------------------------------------------------------------------------------------- | | `Create` | Added | [ProductCatalog.TrialOffer](/api/product-catalog/trial-offer/object?api-version=2026-03-25.preview) | | Parameters | Change | Resources or methods | | -------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `TrialOffer` | Added | [InvoiceScheduleDetailsAmendmentItemActionAddOptions](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-amendments-item_actions-add), [InvoiceScheduleDetailsAmendmentItemActionSetOptions](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-amendments-item_actions-set), [InvoiceScheduleDetailsPhaseItemOptions](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-schedule_details-phases-items), [QuoteLine.Action.AddItem](/api/quote_lines/object?api-version=2026-03-25.preview#quote_line_object-actions-add_item), [QuoteLine.Action.SetItems](/api/quote_lines/object?api-version=2026-03-25.preview#quote_line_object-actions-set_items), [QuoteLineActionAddItemOptions](/api/quotes/create?api-version=2026-03-25.preview#create_quote-lines-actions-add_item), [QuoteLineActionSetItemOptions](/api/quotes/create?api-version=2026-03-25.preview#create_quote-lines-actions-set_items), `QuotePreviewSubscriptionSchedule.Phase.Item`, [SubscriptionSchedule.Phase.Item](/api/subscription_schedules/object?api-version=2026-03-25.preview#subscription_schedule_object-phases-items), [SubscriptionScheduleAmendmentItemActionAddOptions](/api/subscription_schedules/amend?api-version=2026-03-25.preview#amend_subscription_schedule-amendments-item_actions-add), [SubscriptionScheduleAmendmentItemActionSetOptions](/api/subscription_schedules/amend?api-version=2026-03-25.preview#amend_subscription_schedule-amendments-item_actions-set), [SubscriptionSchedulePhaseItemOptions](/api/subscription_schedules/create?api-version=2026-03-25.preview#create_subscription_schedule-phases-items) | | `CurrentTrial` | Added | [InvoiceSubscriptionDetailsItemOptions](/api/invoices/create_preview?api-version=2026-03-25.preview#create_invoice-subscription_details-items), [SubscriptionItem](/api/subscription_items/object?api-version=2026-03-25.preview), [SubscriptionItemCreateOptions](/api/subscription_items/create?api-version=2026-03-25.preview), [SubscriptionItemOptions](/api/subscriptions/update?api-version=2026-03-25.preview#update_subscription-items), [SubscriptionItemUpdateOptions](/api/subscription_items/update?api-version=2026-03-25.preview) | | `BillingCycleAnchor` | Added | [Subscription.TrialSettings.EndBehavior](/api/subscriptions/object?api-version=2026-03-25.preview#subscription_object-trial_settings-end_behavior), [SubscriptionTrialSettingsEndBehaviorOptions](/api/subscriptions/update?api-version=2026-03-25.preview#update_subscription-trial_settings-end_behavior) | ## Upgrade #### REST API 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. 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](https://docs.stripe.com/api/versioning.md) to include `Stripe-Version: 2026-03-25.preview` 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Ruby 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Ruby SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Python 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Python SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### PHP 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your PHP SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Java 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Java SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Node.js 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Node SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Go 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Go SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### .NET 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your .NET SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).