# Ajoute des offres d’essai configurables pour les éléments d’abonnement ## Nouveautés Ajoute la possibilité de créer et de gérer des offres d’essai pour les éléments d’abonnement à l’aide de la nouvelle API [Trial Offers](https://docs.stripe.com/api/product-catalog/trial-offer.md?api-version=2026-03-25.preview). Définissez un [tarif](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-03-25.preview#product_catalog_trial_offer_object-price) applicable pendant la période d’essai, puis un autre une fois celle-ci terminée. Vous pouvez configurer la [durée](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-03-25.preview#product_catalog_trial_offer_object-duration) d’une offre d’essai en définissant une date de fin ou en spécifiant un nombre d’intervalles de tarification. Ajoute la possibilité d’attribuer une offre d’essai à un élément d’abonnement et, le cas échéant, de spécifier une date de fin d’essai pour cet élément d’abonnement en utilisant le nouveau paramètre [current_trial](https://docs.stripe.com/api/subscription_items/create.md?api-version=2026-03-25.preview#create_subscription_item-current_trial). Ajoute également la possibilité de contrôler si l’ancrage du cycle de facturation d’un abonnement est réinitialisé à la fin de la période d’essai en définissant le nouveau paramètre [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). ## Modifications #### API REST | | 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) | ## Mise à niveau #### API REST 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Si vous utilisez un SDK, passez à une version correspondant à celle de l’API. - Si vous n’utilisez pas de SDK, mettez à jour vos [requêtes API](https://docs.stripe.com/api/versioning.md) pour inclure la `version Stripe : 2026-03-25.preview` 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### Ruby 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK Ruby vers la dernière version. 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### Python 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK Python vers la dernière version. 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### PHP 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK PHP vers la dernière version. 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### Java 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK Java vers la dernière version. 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### Node.js 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK Node vers la dernière version. 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### Go 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK Go vers la dernière version. 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### .NET 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK .NET vers la dernière version. 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).