サブスクリプションの柔軟性を高める

柔軟な請求モードを使用して、機能を強化し、追加機能にアクセスできます。

柔軟な請求モードは、正確で予測可能な請求書動作と、サブスクリプションを管理するための追加機能を提供します。サブスクリプションに billing_mode=flexibleを設定すると、サブスクリプションオブジェクトのライフサイクル全体、およびアップグレード、ダウングレード、キャンセルに対する動作が変わります。

柔軟な請求モードでは、従来の請求モードとは異なるサブスクリプション管理機能を使用できます。詳細については、従来の請求モードと柔軟な請求モードの違いをご覧ください。

柔軟な請求モードを使用するには、導入が Stripe API バージョン 2025-06-30.basil 以降である必要があります。API バージョンをアップグレードする方法をご覧ください。柔軟な請求モードから従来の請求モードにダウングレードすることはできません。

制限事項

柔軟な請求モードは、Stripe Billing のすべての機能と互換性があるわけではありません。以下の機能には互換性がなく、柔軟な請求モードを有効にしてサブスクリプションを作成および更新すると、400 ステータスコードが返されます。

有料トライアル
レガシーの従量課金
pay_immediately=false を使用するレガシーのサードパーティー税金実装
事前請求プライベートプレビュー版
レガシーの max_occurences パラメーターの使用

請求モードを設定

柔軟な請求モードに対応した新しいサブスクリプションを作成する

導入の API バージョンに関係なく、ダッシュボードで柔軟な Billing モードで Subscriptions を作成および更新できます。Stripe API でこれらの Subscriptions を完全に変更するには、導入が 2025-06-30.basil 以降である必要があります。使用しているバージョンを確認するには、ワークベンチ概要に移動して、API バージョンセクションを確認します。そこからアップグレードをクリックして、新しいバージョンにアップグレードします。

ダッシュボードでサブスクリプションページに移動します。
+サブスクリプションを作成する を選択します。
高度な設定セクションまでスクロールします。
請求モード を柔軟に設定します。

既存のサブスクリプションを柔軟な請求モードに移行する

既存のサブスクリプションを Flexible 請求書モードに移行できます。柔軟な動作は、移行後のサブスクリプションのすべての新しいアクティビティに対して有効になります。ただし、Stripe は、保留中の比例配分「インボイスアイテム」を含め、移行前に作成されたリソースを再計算しません。

柔軟な請求モードを使用するには、Stripe API バージョン 2025-06-30.basil 以降で実行されているシステムが必要です。使用中のバージョンを確認するには、Workbench の概要に移動して API バージョン セクションをご覧ください。その後、アップグレード をクリックして新しいバージョンにアップグレードします。

ダッシュボードのサブスクリプションページで、移行するサブスクリプションを選択します。
アクション、サブスクリプションを更新 の順に選択します。
高度な設定セクションまでスクロールします。
請求モード を柔軟に設定し、サブスクリプションを更新 を選択します。

従来の請求モードと柔軟な請求モードの相違点

貸方の比例配分の計算

クレジット比例配分は、顧客が請求期間終了前にサブスクリプションをダウングレードするか、サブスクリプションアイテムをキャンセルしたときに発行されます。柔軟な請求モードでは、以前に顧客に引き落とした元の金額に基づいてクレジット比例配分が計算されます。

クレジット比例配分計算の概要については、クレジット比例配分をご覧ください。

クラシック	フレキシブル
サブスクリプションの更新によってクレジット比例配分が生成される場合、クレジット比例配分の金額は、サブスクリプションアイテムの現在の価格、税金、数量、最後に使用された割引の値に基づいて計算されます。	サブスクリプションの更新によってクレジット比例配分が生成される場合、これらの比例配分では現在のサブスクリプション値ではなく、元の金額が使用されます。

比例配分の割引適用

割引は、均等に配分されるのではなく、比例配分計算時に各サブスクリプションアイテムに比例して適用されます。これにより、特に項目単位で請求する場合や、割引が均等に配分されていない項目をキャンセルする場合は、比例配分が多くなります。

クラシック	フレキシブル
割引はすべてのサブスクリプション項目に均等に配分されます。	比例配分を計算するときに、割引は各サブスクリプション項目に按分して適用されます。

従量課金ベースの料金体系

従量制ベースの項目を追加するときに項目の金額がゼロにならないようにする

柔軟な請求モードでは、従量制ベースの項目をサブスクリプションに追加しても、金額ゼロの項目は作成されません。その結果、請求書が空の場合は、作成されません。

たとえば、サブスクリプションの作成時または更新時に月次の従量制ベースの項目を追加する場合、次のようになります。

クラシック	フレキシブル
請求書で従量制ベースの項目の項目が生成されます。これは、`proration_behavior=always_invoice` を使用して、サブスクリプションを循環せずに更新して従量課金項目を追加する場合にも適用されます。	0 USD の項目は、従量制ベースの項目の請求書に追加されません。結果として生成される請求書に項目が含まれていない場合、項目は生成されません。

レポート時点の価格に基づく請求書従量制ベースの項目アイテム

柔軟な請求モードでは、最新の料金ではなく、使用量が報告された時点で有効な料金に基づいて、使用量の対価が請求されます。

たとえば、顧客の使用量は以下のように報告されます。

1 月 5 日の使用量: 100 コールあたり 0.1 USD で 1000 回の API コール (料金 A)。
1 月 15 日の価格変更: 価格は 100 コールごとに 0.15 USD に変更されます (価格 B)。
1 月 20 日の使用量: 500 回の API コール。

クラシック	フレキシブル
Stripe は、現在の価格に変更されてから報告された使用状況に対してのみ請求します。価格 B で 500 API コール (100 コールごとに ) = 請求書の合計金額 = 。	Stripe は、現在の期間におけるすべての使用状況について、報告時点で有効な価格で請求します。価格 A で 1,000 API コール (100 コールごとに ) = 価格 B で 500 API コール (100 コールごとに ) = 請求書の合計金額 = 。

クラシック

フレキシブル

Stripe は、現在の価格に変更されてから報告された使用状況に対してのみ請求します。

価格 B で 500 API コール (100 コールごとに ) =

請求書の合計金額 = 。

Stripe は、現在の期間におけるすべての使用状況について、報告時点で有効な価格で請求します。

価格 A で 1,000 API コール (100 コールごとに ) =
価格 B で 500 API コール (100 コールごとに ) =

請求書の合計金額 = 。

従量制ベースアイテムを削除する際の未請求の使用状況の請求書

proration_behaviorの値に応じて、柔軟なBillingモードにより、使用量ベースのサブスクリプション項目を削除する際に、未請求の使用状況のインボイスアイテムが生成されることがあります。これは、APIを使用した削除や、期間途中に発生するスケジュールフェーズの移行時に適用されます。サブスクリプションアイテムの current_period_end と一致するフェーズ移行の場合、削除された利用料ベースのサブスクリプションアイテムに対応する請求書ラインアイテムが含まれた請求書が作成されます。

Scenario	クラシック	フレキシブル
API を使用してサブスクリプションまたはスケジュールを更新	利用料ベースのサブスクリプションアイテムを削除した場合、インボイスアイテムは未請求の使用量に対して生成されません。	従量制ベースのサブスクリプションアイテムを削除すると、未請求の使用状況のインボイスアイテムが生成されます。
スケジュールフェーズの移行	利用料ベースのサブスクリプション項目を削除すると、未請求の利用料に対して請求書が生成されます (が、インボイスアイテムは生成されません)。	新しいフェーズの `proration_behavior` の値に応じて: `create_prorations`: 利用料ベースのサブスクリプション項目を削除すると、未請求の利用料に対してインボイスアイテムが生成されます。 `always_invoice`: 未請求の使用量に対してインボイスアイテムが作成され、即時に請求されます。 `none`: インボイスアイテムは作成されません。

請求サイクルの起点をリセットする

柔軟な請求モードでは、billing_cycle_anchor を unchanged 以外の値に明示的に設定した場合にのみ、サブスクリプション更新の請求サイクルの起点がリセットされます。

クラシック	柔軟性
The `billing_cycle_anchor` is automatically reset to the current date when switching a subscription to a different price with a different recurring interval, from zero-amount prices to non-zero price or moving cancel_at to a date before the next time the subscription renews.	`billing_cycle_anchor` が自動的にリセットされることはありません。

従量制項目を含むサブスクリプションスケジュールフェーズ移行の統合請求

Flexible billing mode consistently generates a single invoice when a subscription renews. This change eliminates separate invoices for removed usage-based items and improves billing consistency.

従量制ベースの項目を含むサブスクリプションがフェーズ間で移行する場合:

クラシック	フレキシブル
2 つの請求書が生成されます。	1 つの統合請求書が生成されます。この請求書には、従量制ベースの項目とライセンス項目の両方が含まれ、従量課金には前のフェーズの割引が適用され、次のフェーズの税率が使用されます。

定期サブスクリプションのキャンセル

You can disable prorations for a truncated first billing period (when setting cancel_at on creation) using the proration_behavior parameter.

クラシック	フレキシブル
Prorations are applied to the first billing period.	Prorations aren’t applied to the first billing period.

サブスクリプションを遡及適用する

遡及適用が通常の請求と一致する場合、柔軟な請求モードでは、遡及適用範囲内の請求期間ごとに個別の請求書の項目を作成します。また、明示的に設定されていない場合は、請求書サイクルの起点を自動的に backdate_start_date 調整します。ただし、結果の請求書に 250 件を超える項目がある場合は遡及適用はサポートされません。

For example, a subscription needs to be backdated due to a missed invoice for the past two billing periods. The customer was invoiced for 2 different backdated periods:

請求期間 1 (3 月 1 日から 3 月 31 日):
- 報告された使用量: 100 GB のストレージを使用。
- 料金: 10 GB あたり 10 USD。

請求期間 2 (4 月 1 日から 4 月 30 日):

報告された使用量: 150 GB のストレージを使用。
料金: 10 GB あたり 10 USD。

サービスプロバイダーは、両方の請求期間をカバーするために請求書を遡及適用することにしました。3 月 1 日から 4 月 30 日まで。

クラシック	柔軟性
遡及適用された期間全体の支払いは、1 つの項目としてまとめて計算されます。支払い合計額: 250 GB = 25 x 10 USD = 250 USD この金額は、請求書の 1 つの項目として表示されます。	Backdated time ranges are split into multiple invoice line items according to billing period boundaries. Total charges: 請求期間 1 (3 月): 100 GB = 10 x 10 USD = 100 USD (別の項目として)。請求期間 2 (4 月): 150 GB = 15 x 10 USD = 150 USD (別の項目として)。

トライアル

後続のトライアルのトライアル開始日を更新する

柔軟な請求モードでは、後続のトライアルがあるサブスクリプションに、最新のトライアル開始日を適用します。

たとえば、次のような場合です。

トライアル期間: 1 月 1 日から 2 月 1 日まで
通常の請求期間: 2 月 1 日から 3 月 1 日まで
トライアル期間: 3 月 1 日から 4 月 1 日まで

クラシック	フレキシブル
`subscription.trial_start` は常に、サブスクリプションで開始された最初のトライアルを示します。	`subscription.trial_start` は、サブスクリプションの最新のトライアルの開始を示します。

サブスクリプションのキャンセル時に元のトライアル終了日を保持する

柔軟な請求モードでは、cancel_at 日付を変更しても trial_end が保持されます。

クラシック	柔軟性
`trial_end` の日付が `cancel_at` より後の場合、`trial_end` はキャンセル日に設定されます。`cancel_at` が後で更新または削除された場合、`trial_end` は元の値に設定されません。	`cancel_at` を使用してサブスクリプションのキャンセルをスケジュールしても、`trial_end` の日付は変更されなくなりました。これにより、キャンセル日の更新に関係なく、トライアルが意図した期間実行されます。

トライアル期間の項目の説明を標準化する

柔軟な請求書では、トライアル期間中、従量制ベースの項目とライセンスベースの項目の両方に対して一貫した説明形式が使用されます。

たとえば、月次のコーヒーサブスクリプション (ライセンス) とalpaca_ai_tokens サブスクリプション (従量制ベース) がある場合、サブスクリプションの説明は以下のように表示されます。

クラシック フレキシブル

クラシック	フレキシブル
ライセンスアイテムはテンプレート `{product name}` のトライアル期間を使用し、従量制ベース項目は `{quantity} x {product name} (無料トライアル)` を使用します。ライセンス品目の場合: `Trial period for monthly coffee subscription` 従量課金項目の場合: `10 x monthly alpaca_ai_tokens (Free trial)`	同じ形式 `Free trial for {quantity} x {product name}` がすべての項目タイプに適用され、トライアル情報がより均一に表示されています。これらの説明もローカライズされています。ライセンス品目の場合: `Free trial for 1 x monthly coffee subscription` 従量課金項目の場合: `Free trial for 10 x monthly alpaca_ai_tokens subscription`

ライセンスアイテムはテンプレート {product name} のトライアル期間を使用し、従量制ベース項目は {quantity} x {product name} (無料トライアル) を使用します。

ライセンス品目の場合:
- Trial period for monthly coffee subscription
従量課金項目の場合:
- 10 x monthly alpaca_ai_tokens (Free trial)

同じ形式 Free trial for {quantity} x {product name} がすべての項目タイプに適用され、トライアル情報がより均一に表示されています。これらの説明もローカライズされています。

ライセンス品目の場合:
- Free trial for 1 x monthly coffee subscription
従量課金項目の場合:
- Free trial for 10 x monthly alpaca_ai_tokens subscription

トライアル項目の再請求

柔軟な請求モードでは、トライアル中に行われた変更に対してのみ項目が生成されます。変更のない既存の項目は再請求されません。

たとえば、price_a が指定されているトライアル中のサブスクリプションに別のトライアル項目 price_b を追加するために更新を行う場合、以下のようになります。

クラシック	柔軟性
トライアル中の変更は、請求書なし、またはサブスクリプションの全状態を再表示した請求書になります。	トライアル中の変更は一貫して、トライアル外での変更と同等の項目になります。たとえば、サブスクリプションに新しい料金が追加されると、その追加を表す項目も追加されます。

保留中のインボイスアイテム

保留中の請求書項目を一貫して含める

柔軟な請求モードでは、proration_behavior = always_invoice の請求サイクルアンカーのリセットによって生成された請求書に含まれている、利用可能なすべての保留中の請求書項目が含まれます。

クラシック	フレキシブル
請求サイクルの起点をリセットした請求書には保留中の項目は含まれますが、`always_invoice`請求書には含まれていません。	保留中の請求書項目は、サブスクリプションで生成されるすべての請求書に必ず含まれます。

同じサブスクリプションの混在期間プライベートプレビュー版

柔軟な請求モードでは、混合期間のサブスクリプションにアクセスできます。期間が混在するサブスクリプションを使用すると、1 つのサブスクリプションで異なる複数の継続価格を請求できます。これにより、1 つのサブスクリプション内で異なる料金体系を組み合わせることができます。

クラシック	フレキシブル
サポート対象外。サブスクリプション項目すべてに、同じ期間と期間数で料金を設定する必要があります。	混合期間のサブスクリプションを作成します。サブスクリプション項目には、さまざまな期間または期間数の継続料金を設定できます。たとえば、月額料金と年額料金を同じサブスクリプションに混在させることができます。