# サブスクリプションでトライアルの提供を設定 サブスクリプション商品に対して無料または有料のトライアルを提供します。 ![](https://b.stripecdn.com/docs-statics-srv/assets/trial-offer.2128af954f90482fce40e29d1604a01b.png) [Trial Offer](https://docs.stripe.com/api/product-catalog/trial-offer.md?api-version=2026-09-30.endive) API を使用して、1 つの API 連携で[サブスク](https://docs.stripe.com/subscriptions.md)の無料導入期間と有料導入期間の両方を管理できます。トライアルオファーを使用すると、購入意欲の高いリードを絞り込み、トライアルの悪用を減らし、期間限定で顧客に割引レートを提供できます (たとえば、オファーの最初の 1 週間は 1 USD など)。 ## ユースケース トライアルオファーを使用すると、Stripe でプロモーション価格設定と商品提供の実験を直接実行できます。トライアルオファーの一般的なユースケースは次のとおりです。 | ユースケース | 説明 | | --- | --- | | **割引トライアル** | トライアルから有料のサブスクリプションへの移行率を向上させて収益を生み出すには、割引料金で利用できるトライアルを設定します。たとえば、4 USDの初期料金を 4 週間提供、または 7 日間の無料トライアルを提供するということです。 | | **無料トライアル** | 無料トライアルサブスクリプションを提供するには、サブスクリプションに0 USDの項目を含めます。 | | **トライアルのアップグレード** | プレミアム機能を追加販売するには、アップグレード・トライアルを設定します。たとえば、基本プランの顧客に基本プランの料金でプレミアム機能を使用できる 7 日間のトライアルを提供します。そしてトライアルの終了時に顧客を自動的にプレミアム料金に移行させます。 | | **商品別のトライアル** | アドオン、AI パック、その他の機能バンドルを販売する場合、項目別にトライアルを設定できます。サブスクリプションの 1 つのライン項目についてのみトライアルを顧客に提供し、他のアイテムについては正規の価格で請求できます。 | ## Before you begin - 実装では、[2026-09-30.endive](https://docs.stripe.com/changelog.md#2026-09-30.endive) 以降を使用する必要があります。リクエストヘッダーで、この [Stripe バージョン](https://docs.stripe.com/api/versioning.md) を指定してください。 - トライアルのオファーを利用するには、請求モードを [flexible](https://docs.stripe.com/billing/subscriptions/billing-mode.md#create-a-new-subscription-with-flexible-billing-mode) に設定して新しいサブスクを作成するか、`classic` 請求モードを使用している既存のサブスクを `flexible` に更新する必要があります。 ### 制限事項 **実装の制限** - トライアルのオファーは、ダッシュボードまたは Subscriptions API を使用したサブスクの作成時および更新時にサポートされています。以下の UI 連携では、トライアルのオファーはサポートされていません。 - [プライベートプレビュー](https://docs.stripe.com/payments/checkout/trial-offers.md)以外の [Checkout セッション](https://docs.stripe.com/payments/subscriptions.md)の実装。招待されたアカウントは、フレキシブル請求モードの Stripe ホスト型の Checkout でトライアルオファーを利用できます。 - [料金表](https://docs.stripe.com/payments/checkout/pricing-table.md) - [Payment Links](https://docs.stripe.com/payment-links.md) - [Checkout セッションを使用する Elements](https://docs.stripe.com/payments/elements.md) - トライアルオファーと従来の `trial_end` パラメーターを併用することはできません。割引トライアルと無料トライアルを設定するには、Trial Offer API を使用することをお勧めします。トライアルオファーとサブスクの無料トライアル期間のどちらかを選択するかについては、[無料トライアル期間とトライアルオファーを比較する](https://docs.stripe.com/billing/subscriptions/trials/compare.md)を参照してください。 **ダッシュボードの制限** - サブスクスケジュールを備えたトライアルオファーは公開プレビュー段階であり、ダッシュボードではサポートされていません。管理するには、API を使用してください。 - カスタマーポータルを使用して、トライアルオファーを表示およびキャンセルできます。また、トライアルオファーが設定されたサブスクを再有効化することも可能です。トライアルオファーが設定されたサブスクの更新、一時停止、再開はできません。 **請求と分析の制限** - トライアルオファーは、継続サブスクリプションアイテムにのみ適用されます。非継続アイテムは、有料トライアルや割引トライアル料金の対象にはなりません。 - サブスクリプションの作成後にトライアル期間を変更したり、トライアルの延長と短縮をスケジュールしたりすることはできません。 - トライアル後の価格は、サブスクにすでに設定されている価格とは異なるものにする必要があります。 - トライアルの終了後、Stripe により、サブスクからトライアルオファーが削除されます。 - トライアル終了時に、単一のサブスク項目の削除をスケジュールする標準的な方法はありません。 - [Billing Analytics](https://docs.stripe.com/billing/subscriptions/analytics.md) では、トライアルオファーの項目はトライアル期間中、MRR に算入されません。同じサブスクのほかの項目は、引き続き MRR に算入されます。 ## トライアルオファーの仕組み サブスクでは、指定された価格で商品の代金が顧客に定期的に請求されます。トライアルオファーを作成する場合、商品のトライアル価格と期間を指定します。トライアル終了時、サブスクは自動的に正規の価格または設定した別の価格に移行します。 > トライアルオファーを作成するには、2 つの独立した継続的な Price オブジェクトが必要です。1 つはトライアル期間用で、もう 1 つはトライアル終了後用です。 トライアルオファーは、[商品や価格](https://docs.stripe.com/products-prices/how-products-and-prices-work.md)の代わりにはなりません。`Trial Offer` は、期間限定で割引価格または無料の価格を [サブスク項目](https://docs.stripe.com/api/subscription_items.md) に関連付ける独立したオブジェクトです。項目の [price](https://docs.stripe.com/api/subscription_items/object.md?#subscription_item_object-price) は、トライアルの有効期間中はトライアル価格となり、終了後は移行後の価格となります。 ## トライアルオファーを作成する #### ダッシュボード ダッシュボードでトライアルオファーを作成するには: 1. [商品](https://dashboard.stripe.com/products)ページに移動します。 2. 商品をクリックして、商品の詳細ページを開きます。 3. **トライアル**セクションで、プラス記号 (+) をクリックします。 4. **トライアルを作成**ダイアログに、トライアル価格、期間、終了時の動作を入力します。 5. **作成**をクリックします。 サブスクリプションエディターからトライアルオファーを作成することもできます。 1. [サブスクリプション](https://dashboard.stripe.com/subscriptions)ページに移動します。 2. **+ サブスクリプションを作成**をクリックするか、既存のサブスクリプションをクリックして**アクション** > **サブスクリプションを更新**を選択します。 3. **トライアルを追加**をクリックします。 4. ダイアログで **+ トライアル**を選択し、新しいトライアルオファーを作成します。 5. トライアル価格、期間、終了時の動作など、トライアルの詳細を入力します。 6. **作成**をクリックします。 #### API [トライアルオファーを作成](https://docs.stripe.com/api/product-catalog/trial-offer/create.md?api-version=2026-09-30.endive)するには、[price.id](https://docs.stripe.com/api/prices/object.md#price_object-id) を使用して [price](https://docs.stripe.com/api/product-catalog/trial-offer/create.md?api-version=2026-09-30.endive#create_product_catalog_trial_offer-price) を渡し、トライアル期間中の費用を定義します。無料のトライアルの場合は 0 USD に、有料のトライアルの場合は任意の正の金額に設定できます。 トライアルの [duration.type](https://docs.stripe.com/api/product-catalog/trial-offer/create.md?api-version=2026-09-30.endive#create_product_catalog_trial_offer-duration-type) を `relative` に設定し、[duration.relative.iterations](https://docs.stripe.com/api/product-catalog/trial-offer/create.md?api-version=2026-09-30.endive#create_product_catalog_trial_offer-duration-relative-iterations) を使用して請求間隔の数を定義します。 次に、[end_behavior.transition.price](https://docs.stripe.com/api/product-catalog/trial-offer/create.md?api-version=2026-09-30.endive#create_product_catalog_trial_offer-end_behavior-transition-price) を使用して、トライアル終了時にサブスクが使用する価格を指定します。オプションで `nickname` を設定し、トライアルオファーの内部ラベルを追加できます。 ### 相対的な期間を指定してトライアルオファーを作成する ```curl curl https://api.stripe.com/v1/product_catalog/trial_offers \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d price=price_trial \ -d "duration[relative][iterations]=1" \ -d "duration[type]=relative" \ -d "end_behavior[transition][price]=price_regular" ``` ### タイムスタンプ期間を指定してトライアルオファーを作成する > タイムスタンプによるトライアルオファーの期間設定は、[公開プレビュー](https://docs.stripe.com/release-phases.md)段階です。開発中に機能が変更される可能性があります。 ```curl curl https://api.stripe.com/v1/product_catalog/trial_offers \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d price=price_trial \ -d "duration[type]=timestamp" \ -d "end_behavior[transition][price]=price_regular" ``` トライアルオファーをアーカイブし、新規のサブスクで使われないようにするには、[active](https://docs.stripe.com/api/product-catalog/trial-offer/update.md?api-version=2026-09-30.endive) を `false` に設定します。アーカイブを解除するには、`true` に設定します。 ## 新しいサブスクリプションにトライアルオファーを関連付ける #### ダッシュボード ダッシュボードで新しいサブスクリプションにトライアルオファーを追加するには。 1. [サブスクリプション](https://dashboard.stripe.com/subscriptions)ページに移動します。 2. **+ サブスクリプションを作成**をクリックします。 3. **トライアルを追加**をクリックします。 4. ダイアログで既存のトライアルオファーを選択するか、**New Trial** を選択して、サブスクに追加する新しいトライアルオファーを作成します。 #### API トライアルオファーを[サブスク](https://docs.stripe.com/api/subscriptions/object.md)に関連付けるには、[trial_offer.id](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-09-30.endive#product_catalog_trial_offer_object-id) を[items.current_trial.trial_offer](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-current_trial) パラメーターで指定します。 #### Accounts v2 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d "billing_mode[type]=flexible" \ -d "items[0][current_trial][trial_offer]=to_123" \ -d "items[0][quantity]=1" ``` #### Customer v1 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "customer={{CUSTOMER_ID}}" \ -d "billing_mode[type]=flexible" \ -d "items[0][current_trial][trial_offer]=to_123" \ -d "items[0][quantity]=1" ``` ## トライアルオファーでサブスクリプションを更新する ### 既存のサブスクリプションにトライアルオファーを追加する #### ダッシュボード ダッシュボードで既存のサブスクリプションにトライアルオファーを追加するには。 1. [サブスクリプション](https://dashboard.stripe.com/subscriptions)ページに移動します。 2. 更新するサブスクリプションをクリックして、 **アクション** > **サブスクリプションの更新** を選択します。 3. **トライアルを追加**をクリックします。 4. ダイアログで既存のトライアルオファーを選択するか、**+ トライアル**を選択してサブスクリプションに追加する新しいトライアルオファーを作成します。 #### API 既存のサブスクにトライアルオファーを追加するには、[trial_offer.id](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-09-30.endive#product_catalog_trial_offer_object-id) を [items.current_trial.trial_offer](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-current_trial) パラメーターで指定します。 ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "items[0][current_trial][trial_offer]=to_123" ``` ### 既存のアイテムを含むサブスクリプションにトライアルオファーを追加する #### ダッシュボード ダッシュボードで既存の項目があるサブスクリプションに別の項目としてトライアルオファーを追加するには。 1. [サブスクリプション](https://dashboard.stripe.com/subscriptions)ページに移動します。 2. 更新するサブスクリプションをクリックして、 **アクション** > **サブスクリプションの更新** を選択します。 3. **トライアルを追加**をクリックします。 4. ダイアログで既存のトライアルオファーを選択するか、**+ トライアル**を選択してサブスクリプションに追加する新しいトライアルオファーを作成します。 #### API 既存の項目があるサブスクにトライアルオファーを別の項目として追加するには、[items](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items) 配列に項目を追加し、items 配列内の [trial_offer.id](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-09-30.endive#product_catalog_trial_offer_object-id) を [items.current_trial.trial_offer](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-current_trial) パラメーターで指定します。 ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "items[0][id]={{SUBSCRIPTIONITEM_ID}}" \ -d "items[1][current_trial][trial_offer]=to_123" \ -d "items[1][quantity]=1" ``` ### サブスクリプション項目をトライアルオファーに変換する 既存のサブスク項目をトライアルオファーに変換するには、[items.id](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-id) を含め、[trial_offer.id](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-09-30.endive#product_catalog_trial_offer_object-id) を [items.current_trial.trial_offer](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-current_trial) パラメーターで指定します。 ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "items[0][id]={{SUBSCRIPTIONITEM_ID}}" \ -d "items[0][current_trial][trial_offer]=to_123" ``` ### トライアルオファーの項目数量を変更する #### ダッシュボード ダッシュボードでトライアルオファー項目の数量を変更するには。 1. [サブスクリプション](https://dashboard.stripe.com/subscriptions)ページに移動します。 2. 更新するサブスクリプションをクリックして、 **アクション** > **サブスクリプションの更新** を選択します。 3. トライアルオファー項目を追加した後、数量フィールドを編集します。 4. **サブスクリプションを更新**をクリックします。 #### API トライアルオファー項目の[数量](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-quantity)を変更するには、サブスクリプションを更新します: ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "items[0][id]={{SUBSCRIPTIONITEM_ID}}" \ -d "items[0][quantity]=2" ``` ## サブスクリプションスケジュールにトライアルオファーを追加する > サブスクスケジュールを備えたトライアルオファーは、[公開プレビュー](https://docs.stripe.com/release-phases.md)段階です。開発中に機能が変更される可能性があります。 タイムスタンプ型のトライアルオファーは、[サブスクスケジュール](https://docs.stripe.com/api/subscription_schedules.md?api-version=2026-03-25.preview)でのみ使用できます。一定の請求間隔後に終了する相対期間のトライアルとは異なり、タイムスタンプ型のトライアルは絶対日付に終了します。これを作成するには、トライアルオファーの [duration.type](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-03-25.preview#product_catalog_trial_offer_object-duration-type) を `timestamp` に設定します。 ```curl curl https://api.stripe.com/v1/product_catalog/trial_offers \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d price=price_trial \ -d "duration[type]=timestamp" \ -d "end_behavior[transition][price]=price_regular" ``` 次に、[phases.items.trial_offer](https://docs.stripe.com/api/subscription_schedules/create.md?api-version=2026-03-25.preview#create_subscription_schedule-phases-items-trial_offer) を使用して、トライアルオファーをサブスクスケジュールの [phase](https://docs.stripe.com/api/subscription_schedules/create.md?api-version=2026-03-25.preview#create_subscription_schedule-phases) に関連付けます。 #### Accounts v2 ```curl curl https://api.stripe.com/v1/subscription_schedules \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d start_date=1610403705 \ -d "phases[0][items][0][trial_offer]=to_123" \ -d "phases[0][end_date]=1610403706" ``` #### Customer v1 ```curl curl https://api.stripe.com/v1/subscription_schedules \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d "customer={{CUSTOMER_ID}}" \ -d start_date=1610403705 \ -d "phases[0][items][0][trial_offer]=to_123" \ -d "phases[0][end_date]=1610403706" ``` ## トライアルオファーのあるサブスクリプションを表示 [サブスクリプションを取得](https://docs.stripe.com/api/subscriptions/retrieve.md)すると、レスポンスにはトライアルオファーを含む各項目の設定が含まれます。 ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" ``` ## 有料トライアルの終了時にサブスクリプションをキャンセルする 有料トライアルの終了時にサブスクリプションをキャンセルするには: 1. トライアルオファー付きのサブスクリプションを作成します。 2. キャンセル日をトライアル期間の終了日に設定します。 このフローはオプトインによる更新に対応しているため、デフォルトでは顧客が継続的なサブスクリプションに自動的に移行されることはありません。 #### ダッシュボード ダッシュボードで、有料トライアルの終了時にサブスクリプションをキャンセルするには: 1. [サブスク](https://dashboard.stripe.com/subscriptions)ページで、該当するサブスクを見つけて、オーバーフローメニュー (⋯) をクリックし、**サブスクをキャンセル**を選択します。 2. **カスタムの日**を選択し、トライアルとサブスクリプションを終了する日付を設定します。 3. **サブスクリプションをキャンセル**をクリックします。 詳細については、[サブスクリプションをキャンセル](https://docs.stripe.com/billing/subscriptions/cancel.md#canceling)をご覧ください。 #### API 有料トライアルの終了時にサブスクリプションをキャンセルするには、[cancel_at](https://docs.stripe.com/api/subscriptions/update.md?#update_subscription-cancel_at) パラメーターをトライアル期間の終了日に設定します: #### Accounts v2 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d "items[0][current_trial][trial_offer]=to_123" \ -d "items[0][quantity]=1" \ -d cancel_at=1610403706 ``` #### Customer v1 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "customer={{CUSTOMER_ID}}" \ -d "items[0][current_trial][trial_offer]=to_123" \ -d "items[0][quantity]=1" \ -d cancel_at=1610403706 ``` ## トライアルオファーを他の機能とともに使用する ### 従量課金を使用したトライアルオファー [Price](https://docs.stripe.com/api/prices/object.md) オブジェクトを作成する際に、継続価格ではなく従量価格を指定して、トライアルオファーに関連付けることができます。これにより、同じ[従量課金](https://docs.stripe.com/billing/subscriptions/usage-based.md)機能を割引価格で提供できます。 従量制価格を使用するには、[usage_type](https://docs.stripe.com/api/prices/object.md?#price_object-recurring-usage_type) を `metered` に設定し、使用状況を追跡する既存の [meter](https://docs.stripe.com/api/prices/object.md?#price_object-recurring-meter) を追加します。 ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d currency=usd \ -d billing_scheme=per_unit \ -d unit_amount=1 \ -d "recurring[interval]=week" \ -d "recurring[usage_type]=metered" \ -d "recurring[meter]=mtr_123" \ -d "product_data[name]=Trial Period Price" ``` 次に、他の継続価格と同様に、価格をトライアルオファーに関連付けます。 ```curl curl https://api.stripe.com/v1/product_catalog/trial_offers \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d price=price_trial \ -d "duration[relative][iterations]=1" \ -d "duration[type]=relative" \ -d "end_behavior[transition][price]=price_regular" ``` ## その他の考慮事項 ### サブスクリプションのトライアルステータスとトライアルオファー トライアルオファーを使用する場合、サブスクリプションの`ステータス`はトライアルの価格によって決まります。 - **無料トライアル (0 USD)**: サブスクリプションにトライアルオファーのみが含まれ、すべてのトライアルオファー価格が0 USDに設定されている場合、サブスクリプションのステータスは`トライアル`です。これは従来の `trial_end` の動作と一致しており、「カード不要」または標準の無料トライアルフローに最適です。 - **有料のトライアル (>0 USD)**: サブスクリプションに通常の価格項目がある場合、またはトライアルオファーにゼロ以外の価格が設定されている場合、サブスクリプションのステータスは `active`、`incomplete`、または `past_due` になります。この動作は、トライアルオファーのない他のサブスクリプションと同様です。有料のトライアルでは決済が即時に成功する必要があるため、サブスクリプションは標準の `PaymentIntent` ライフサイクルに従います。これにより、顧客がプロモーション価格を支払う場合でも、継続決済の全額を支払う場合でも、既存の請求ロジック (Webhook など)の一貫性が保たれます。 ### イベント トライアルが変更されるたびに、[イベント](https://docs.stripe.com/api.md#event_types)がトリガーされます。導入でイベントが処理されていることを確認してください。たとえば、トライアルが終了する前に顧客にメールを送信できます。[サブスクリプションイベントの処理](https://docs.stripe.com/billing/subscriptions/webhooks.md#events)の詳細はこちらをご覧ください。 次の表では、トライアル終了前、トライアルサブスクを一時停止またはキャンセルする場合、およびサブスクを再開して有効になった場合にトリガーされるイベントについて説明しています。 | イベント | 説明 | ユースケース | | --- | --- | --- | | `customer.subscription.deleted` | サブスクリプションが終了すると送信されます。 | このイベントに応じて、プロダクトへのアクセスの提供を停止します。サブスクの `missing_payment_method` の終了時の動作が `cancel` に設定されている場合、決済手段がない状態でトライアルが終了すると、サブスクは `canceled` ステータスに移行し、このイベントを送信します。 | | `customer.subscription.resumed` | サブスクリプションが一時停止されなくなったときに送信されます。このイベントを受け取ったら、サブスクリプションが一時停止されていたときに商品へのアクセスが取り消されていた場合には、商品へのアクセスを顧客に付与します。 | 一時停止されたサブスクは、再開されると有効なサブスクになります。サブスクを再開すると、請求書と対応する Payment Intent が生成される場合があります。この決済が完了しないと、サブスクが `paused` ステータスから移行できません。 | | `customer.subscription.paused` | サブスクリプションが完全に一時停止されると送信されます。サブスクリプションが再開されるまで請求は発生しません。このイベントを受け取ったら、顧客が支払い方法を追加して、サブスクリプションが再開されるまで、商品への顧客のアクセスを取り消すことができます。 | このイベントに応じて、プロダクトへのアクセスの提供を停止します。サブスクの `missing_payment_method` の終了時の動作が `pause` に設定されている場合、決済手段がない状態でトライアルが終了すると、サブスクは `paused` ステータスに移行し、このイベントを送信します。サブスクは明示的に再開されるまで `paused` のままになります。 | | `customer.subscription.updated` | サブスクまたはその項目が変更されたとき (トライアルオファーがトライアル後の価格に移行したときなど) に送信されます。 | サブスク項目の変更に基づいて、アクセスおよび請求の状態を更新します。 | | `customer.subscription.trial_will_end` | ダッシュボードの **Trial ending events** の設定 (デフォルトはトライアル終了の 3 日前) に応じて送信されます。トライアルが設定された間隔より短い場合は、即座にトリガーされます。 | このイベントを使用して、独自のリマインダーメールを送信できます。Stripe がホストするリマインダーメールは、トライアル終了の 7 日前に送信されます。詳細は、[トライアルおよびプロモーションに関するコンプライアンス要件の管理](https://docs.stripe.com/billing/subscriptions/trials/manage-trial-compliance.md)を参照してください。 | ### 請求サイクルのアンカーの動作 既存のサブスクにトライアルオファーを追加しても、サブスクの[請求サイクルのアンカー](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-trial_settings)はリセットされません。サブスクにトライアルオファーを追加すると、トライアルオファーのアイテムの請求サイクルの起点は、サブスクの[請求サイクルのアンカー](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-trial_settings)とは独立して、最初は `trial_start` に設定されます。トライアルオファーを追加しても、サブスクの請求サイクルのアンカーは変わりません。たとえば、2 月 28 日に開始する 2 カ月間のトライアルは、サブスクの請求サイクルのアンカーが各月の 29 日や 30 日でも、4 月 28 日に終了します。 トライアルオファーが有効な間にサブスクの[請求サイクルのアンカー](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-billing_cycle_anchor)を `now` にリセットすると、Stripe はトライアルオファーのアイテムの請求期間も、サブスクの新しい請求サイクルのアンカーに合わせます。このアイテムの `trial_start` と `trial_end` は変わりません。その結果生じる[比例配分](https://docs.stripe.com/billing/subscriptions/prorations.md)は、サブスクの更新時の `proration_behavior` に従って Stripe が処理します。 トライアルオファーが終了して通常の継続的な価格に移行する際、`trial_settings.end_behavior.billing_cycle_anchor` を使用して、サブスクの請求サイクルのアンカーをリセットするかどうかを設定できます。 - `now`(デフォルト): サブスクリプションの `billing_cycle_anchor` をトライアルオファーの完了時刻にリセットします。これにより、通常価格の新しい請求サイクルが作成され、比例配分なしの全額請求書が生成されます。 - `unchanged`: サブスクが最初に作成されたときの元の起点を維持します。トライアル終了日から次の起点日までの期間は、比例配分された金額で請求されます。 たとえば、1 USD の 7 日間のトライアルを提供し、8 日目から最初の 20 USD の月次支払いを 1 ヵ月分満額にする場合、 1. 1 月 1 日: 7 日間のトライアルオファーで作成されたサブスクリプション。 2. 1 月 8 日: トライアルが終了します。`billing_cycle_anchor` は自動的に 1 月 8 日にリセットされます。 3. 請求書: Stripe は、1 月 8 日から 2 月 8 日までの継続価格の全額 20 USD の請求書を生成します。比例配分は適用されません。 #### Accounts v2 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d "items[0][current_trial][trial_offer]={{TRIAL_OFFER_ID}}" \ -d "trial_settings[end_behavior][billing_cycle_anchor]=unchanged" ``` #### Customer v1 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "customer={{CUSTOMER_ID}}" \ -d "items[0][current_trial][trial_offer]={{TRIAL_OFFER_ID}}" \ -d "trial_settings[end_behavior][billing_cycle_anchor]=unchanged" ``` ### 決済手段がない場合の動作 トライアルオファーが終了した際、顧客に決済手段が関連付けられていない場合の Stripe の動作を、`trial_settings.end_behavior.missing_payment_method` を使用して設定できます。Stripe は、各トライアルオファーの終了時にこの動作を適用します。オプションは次のとおりです。 - `create_invoice` (デフォルト): 請求書を作成します。請求書の支払いができない場合、サブスクは `past_due` に移行します。 - `cancel`: サブスクをキャンセルします。 - `pause`: 再開するまでサブスクを一時停止します。 トライアルオファーには、従量課金の項目がサポートされないなど、決済手段がない従来の無料トライアルと同じ制限があります。設定例や詳細については、[決済手段を収集せずに無料トライアルを作成する](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md#create-free-trials-without-payment)を参照してください。 > #### 事前請求はトライアル終了時の動作より優先 > > 事前請求がトライアルの終了後まで延長される場合、`missing_payment_method` が `pause` または `cancel` に設定されていても、事前請求は `trial_settings.end_behavior.missing_payment_method` よりも優先されます。サブスクは、トライアル終了後も通常の請求サイクルを継続します。詳細については、[事前請求](https://docs.stripe.com/billing/subscriptions/prebilling.md)を参照してください。 ## See also - [商品と価格](https://docs.stripe.com/products-prices/overview.md) - [価格](https://docs.stripe.com/api.md#prices) - [サブスクリプション](https://docs.stripe.com/api.md#subscriptions) - [サブスクリプション請求期間の管理](https://docs.stripe.com/billing/subscriptions/billing-cycle.md)