# サブスクリプション項目の設定可能なトライアルオファーを追加

## 新機能

新しい [Trial Offers](https://docs.stripe.com/api/product-catalog/trial-offer.md?api-version=2026-03-25.preview) API を使用して、サブスクリプション項目のトライアルオファーを作成および管理する機能を追加します。トライアル中に使用する [price](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-03-25.preview#product_catalog_trial_offer_object-price) とトライアル後に使用する価格を指定できます。終了タイムスタンプを設定するか、価格間隔の数を指定することで、Trial Offer の [duration](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-03-25.preview#product_catalog_trial_offer_object-duration) を定義することもできます。

サブスクリプション項目に Trial Offer を割り当て、必要に応じて新しい [current_trial](https://docs.stripe.com/api/subscription_items/create.md?api-version=2026-03-25.preview#create_subscription_item-current_trial) パラメーターを使用してサブスクリプション項目のトライアル終了タイムスタンプを指定する機能を追加します。

また、新しい [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) パラメーターを設定することで、サブスクリプションの請求サイクルの起点をトライアル期間の終了時にリセットするかどうかを制御する機能も追加します。

## 変更点

#### 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) |

## アップグレード

#### REST API

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。
   - SDK を使用していない場合は、`Stripe-Version: 2026-03-25.preview` を含めるように [API リクエスト](https://docs.stripe.com/api/versioning.md)を更新してください。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Ruby

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Ruby SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Python

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Python SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### PHP

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. PHP SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Java

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Java SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Node.js

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Node SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Go

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Go SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### .NET

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. .NET SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。