# クラシックとフレキシブル請求モードを比較する

さまざまな Billing モードの違いについて

請求の動作が改善され、新機能を利用できるため、[フレキシブル請求モード](https://docs.stripe.com/billing/subscriptions/billing-mode.md)を使用することをお勧めします。ただし、フレキシブル請求モードに移行すると、実装の動作が変わる可能性があります。実装への影響を理解し、情報に基づいた決定を下すために、以下の相違点を確認してください。

> サブスクをフレキシブル請求モードから従来の請求モードに移行することはできません。

このページでは、サブスクをクラシック請求モードからフレキシブル請求モードに移行する際の変更点について説明します。各セクションで特定の動作の違いを説明しているため、移行前に実装への影響を評価できます。

## 貸方の比例配分の計算

顧客がサブスクをダウングレードするか、請求期間の終了前にサブスク項目をキャンセルすると、クレジットの比例配分が発行されます。フレキシブル請求モードでは、過去に顧客から引き落とされた元の金額に基づいて、クレジットの比例配分が計算されます。

クレジット比例配分計算の概要については、[クレジット比例配分](https://docs.stripe.com/billing/subscriptions/prorations.md#credit-prorations) をご覧ください。

| **クラシック** | **フレキシブル** |
| --- | --- |
| サブスクの更新によりクレジットの比例配分が生成されると、サブスク項目の現在の価格、税金、数量、および最後に使用された割引の値に基づいて、クレジットの比例配分の金額が計算されます。 | サブスクの更新によってクレジット比例配分が発生した場合、これらの比例配分では、現在のサブスク値ではなく、引き落とされた元の金額が使用されます。クレジットされる期間が当初複数の引き落としにまたがって請求された場合、Stripe は対応する元の引き落としごとに 1 つずつ、複数のクレジット比例配分を生成します。 |

### 比例配分の割引適用

[比例配分の計算](https://docs.stripe.com/billing/subscriptions/prorations.md#prorations-and-discounts)では、割引は各サブスク項目に均等に配分されるのではなく、比例して適用されます。これにより、特に項目単位で請求を行う場合や、不均等に配分された割引が適用されている項目をキャンセルする場合に、比例配分の頻度が高くなります。

| **クラシック** | **フレキシブル** |
| --- | --- |
| 割引はすべてのサブスク項目に均等に配分されます。 | 比例配分の計算では、割引は各サブスク項目に比例して適用されます。 |

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

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

フレキシブル請求モードでは、サブスクに従量課金制項目を追加しても、金額が 0 の項目は作成されません。結果として請求書が空になる場合、請求書は生成されません。

たとえば、サブスクの作成または更新時に、月次の従量課金制項目を追加する場合:

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

ただし、これはサイクル中に生成された請求書には適用されません。請求書には、0 USDの明細項目を含む、使用量ベースの項目がすべて含まれます。

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

フレキシブル請求モードでは、最新の価格ではなく、利用が報告された時点で有効であった価格に基づいて利用料金が請求されます。

以下に例を示します。

1. 初期価格は、API コール 100 回ごとに 0.1 USD (価格 A)
2. 1 月 5 日の使用状況: 1000 API コール
3. 1 月 15 日、価格はコール 100 回ごとに 0.15 USD に変更されます (価格 B)
4. 1 月 20 日の使用状況：500 API コール

| **クラシック** | **フレキシブル** |
| --- | --- |
| Stripe は、現在の価格に変更されてから報告された使用状況に対してのみ請求します。

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

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

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

請求書の合計金額 = 。 |

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

`proration_behavior` の値によっては、従量課金制サブスク項目を削除した際に、未請求の利用に対する請求書項目がフレキシブル請求モードによって生成される場合があります。これは、API を使用した削除、または期間の中途で発生するスケジュールのフェーズ移行中の削除に適用されます。任意のサブスク項目の `current_period_end` と同時に行われるフェーズ移行の場合、削除された従量課金制サブスク項目の請求書項目を含む請求書が作成されます。

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

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

フレキシブル請求モードでは、以下の場合を除き、サブスクを更新しても[請求サイクルの起点](https://docs.stripe.com/billing/subscriptions/billing-cycle.md)が維持されます。

- `billing_cycle_anchor` を `unchanged` 以外の値に明示的に設定した場合。
- `trial_end` を更新した場合。起点が以前にそれより後の日付に設定されていたとしても、新しいトライアル終了日に設定されます。

| クラシック | フレキシブル |
| --- | --- |
| サブスクを、継続期間が異なる別の価格に切り替えるか、金額が 0 の価格から 0 以外の価格に変更するか、[cancel_at](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-cancel_at) を次回のサブスク更新前の日付に移動すると、`billing_cycle_anchor` は自動的に現在の日付にリセットされます。 | Classic 列に記載されている変更を行っても、請求サイクルの起点はリセットされません。

顧客が無料プランから有料プランにアップグレードすると、Stripe は保留中の請求書項目を作成し、次回の請求サイクルの請求書に含めます。Stripe は即座に請求書を発行したり、決済を試みたりしないため、必要に応じて決済手段を登録する時間を確保できます。

無料プランから有料プランへのアップグレード時にすぐに請求書を生成するには、`proration_behavior=always_invoice`を渡すか、`billing_cycle_anchor=now`を設定して請求サイクルのアンカーを明示的にリセットします。 |

### 請求サイクルのアンカーのリセット時に、同等の比例配分を相殺する

サブスクの項目を変更せずに請求サイクルのアンカーをリセットすると、Stripe は同等のクレジットとデビットを相殺し、正味の残りのデビットのみを比例配分の請求書項目として生成します。

たとえば、9 月 1 日に作成され、9 月 15 日に請求サイクルのアンカーがリセットされた月次のサブスク (項目の変更なし) を考えてみます。

| `proration_behavior` | **クラシック** | **フレキシブル** |
| --- | --- | --- |
| `create_prorations` | - Stripe は、9 月 15 日から 10 月 15 日までの全期間のデビットを請求書項目として生成します
- Stripe は、9 月 15 日から 10 月 1 日までのクレジットを生成します
- Stripe は、ただちに請求書を作成します | - Stripe は、9 月 15 日から 10 月 1 日までのクレジットとデビットを相殺します
- Stripe は、10 月 1 日から 10 月 15 日までのデビットを `proration=true` 請求書項目として生成します
- Stripe は、ただちに請求書を作成しません |
| `always_invoice` | - Stripe は、9 月 15 日から 10 月 15 日までの全期間のデビットを請求書項目として生成します
- Stripe は、9 月 15 日から 10 月 1 日までのクレジットを生成します
- Stripe は、ただちに請求書を作成します | - Stripe は、9 月 15 日から 10 月 1 日までのクレジットとデビットを相殺します
- Stripe は、10 月 1 日から 10 月 15 日までのデビットを `proration=true` 請求書項目として生成します
- Stripe は、ただちに請求書を作成します |
| `none` | - Stripe は、9 月 15 日から 10 月 15 日までの全期間のデビットを請求書項目として生成します
- Stripe は、9 月 15 日から 10 月 1 日までのクレジットを除外します
- Stripe は、ただちに請求書を作成します | - Stripe は、請求書項目や請求書を生成しません |

比例配分が完全に相殺されないように、BCA のリセットと同時にサブスクの項目も変更した場合、`proration_behavior` に関係なく、フレキシブルモードでは全期間の請求書項目が生成され、即座に請求が作成されます。

### 従量課金制項目を使用したサブスクスケジュールのフェーズ移行に対する連結請求

フレキシブル請求モードでは、サブスクの更新時に常に 1 つの請求書が生成されます。この変更により、削除された従量課金制の項目の個別の請求書が排除され、請求の一貫性が向上します。

従量課金制項目を含むサブスクがフェーズ間で移行する場合:

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

## スケジュールされたサブスクのキャンセル

### カスタマーポータルでのキャンセル

顧客が[カスタマーポータル](https://docs.stripe.com/customer-management/cancellation-page.md)でキャンセルをスケジュールすると、フレキシブル請求モードでは `cancel_at` を `cancel_at_period_end` ではなく直接使用します。`cancel_at` と `cancel_at_period_end` の違いの詳細については、[変更履歴](https://docs.stripe.com/changelog/basil/2025-07-30/cancel-at-enums.md)をご覧ください。

| **クラシック** | **フレキシブル** |
| --- | --- |
| `cancel_at_period_end`は `true`に設定され、`cancel_at` は `current_period_end` タイムスタンプに設定されます。`cancel_at_period_end` は `true` であるため、`current_period_end` が変更されるたびに `cancel_at` が更新されます。 | `cancel_at_period_end` は `false` に設定され、`cancel_at` はすべてのサブスク項目の `current_period_end` の中で最大の値に設定されます。項目の `current_period_end` が変更されても、キャンセル日 (`cancel_at`) は更新されません。 |

### 最初の短縮された請求期間の比例配分の除外

サブスクの作成時に cancel_at を設定し、最初の請求期間が短縮される場合、[比例配分の無効化](https://docs.stripe.com/billing/subscriptions/prorations.md#disable-prorations)の影響はサブスクの請求モードによって異なります。

| **クラシック** | **フレキシブル** |
| --- | --- |
| 短縮された請求期間は比例配分として処理されません。そのため、`proration_behavior=none` を設定しても、Stripe による当該期間の請求を止めることはできません。Stripe は、比例配分の金額ではなく、サブスクの全額に対する請求書項目を追加します。 | 短縮された期間は比例配分として処理されます。`proration_behavior=none` によって項目が完全に抑制されるため、請求書は作成されず、`latest_invoice` は `null` になります。 |

サブスクの更新の場合、更新によって請求書が作成される場合にのみこの動作を適用します。たとえば、`billing_cycle_anchor` の明示的なリセットや、[トライアル](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md)の終了時などが該当します。

## サブスクを遡及適用する

[遡及](https://docs.stripe.com/billing/subscriptions/backdating.md)が通常の請求と整合している場合、フレキシブル請求モードでは、遡及範囲内の各請求期間に対して個別の請求書項目が作成されます。また、明示的に設定されていない場合は、請求サイクルのアンカーが `backdate_start_date` に自動的に合わせられます。結果の請求書に 250 を超える項目がある場合、遡及はサポートされません。

たとえば、過去 2 回の請求期間における請求漏れが原因で、サブスクの開始日を過去に遡らせる必要がある場合です。顧客には、以下の 2 つの異なる遡及期間の請求が行われました。

- 請求期間 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 つの項目として表示されます。 | 過去の時間範囲は、請求期間の境界に従って複数の請求書項目に分割されます。合計請求額:
- 請求期間 1 (3 月):
  - 100 GB = 10 x 10 USD = 100 USD (別の項目として)。
- 請求期間 2 (4 月):
  - 150 GB = 15 x 10 USD = 150 USD (別の項目として)。 |

### 初回請求なしでバックデートした後の後続の比例配分動作

`proration_behavior: 'none'` を指定してバックデートしたサブスクを作成し、バックデートした期間の請求書作成を抑制する場合 (たとえば、[Stripe への移行](https://docs.stripe.com/billing/subscriptions/backdating.md#backdating-no-charge)時)、フレキシブル請求モードとクラシック請求モードでは、後続の更新とキャンセルの処理が異なります。

| **クラシック** | **フレキシブル** |
| --- | --- |
| 後でサブスクを更新またはキャンセルすると、それらの請求期間の請求書が作成されていなくても、Stripe はバックデートした期間の残りの未使用期間に対するクレジット比例配分を生成します。 | フレキシブル請求モードでは、以前に請求された金額に基づいてクレジット比例配分が計算されます。そのため、バックデートした期間に対する請求がない場合、後続の更新やキャンセルでは、その期間のクレジット比例配分は生成されません。 |

## トライアル

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

フレキシブル請求モードでは、後続のトライアルがあるサブスクについて、直近のトライアルの開始日が使用されます。

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

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

| **クラシック** | **フレキシブル** |
| --- | --- |
| `subscription.trial_start` は常に、サブスクで開始された最初のトライアルを指します。 | `subscription.trial_start` は、サブスクの直近のトライアルの開始を指します。 |

### サブスクがキャンセルされた場合に元のトライアル終了日を保持する

フレキシブル請求モードでは、`cancel_at` の日付を変更した場合に、`trial_end` が保持されます。

| クラシック | フレキシブル |
| --- | --- |
| `cancel_at` を `trial_end` の日付よりも前の日付に設定すると、`trial_end` は自動的に `cancel_at` と一致するように変更されます。ただし、`cancel_at` を削除する場合や、`trial_end` の日付よりも後の日付に変更する場合は、`trial_end` が最初にそれ以降の日付であっても、`trial_end` は自動的に変更されません。 | `cancel_at` を使用してサブスクのキャンセルをスケジュールしても、`trial_end` の日付が変更されることはなくなりました。これにより、キャンセルの日付が更新されても、トライアルは予定されていた期間実行されます。 |

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

フレキシブル請求モードでは、トライアル期間中、従量課金制項目とライセンス項目の両方に一貫した説明の形式が使用されます。

たとえば、コーヒーの月次サブスク (ライセンス) と `hypernian_tokens` サブスク (従量課金制) がある場合、サブスクの説明は次のように表示されます。

| **クラシック** | **フレキシブル** |
| --- | --- |
| ライセンスアイテムはテンプレート `Trial period for {product name}` のトライアル期間を使用し、従量制ベース項目は `{quantity} x {product name} (Free trial)` を使用します。

- ライセンス品目の場合:
  - `Trial period for monthly coffee subscription`
- 従量課金項目の場合:
  - `10 x monthly hypernian_tokens  (Free trial)` | 同じ形式 `Free trial for {quantity} x {product name}` がすべての項目タイプに適用され、トライアル情報がより均一に表示されています。これらの説明もローカライズされています。

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

### トライアル項目の再請求

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

たとえば、`price_a` のあるトライアル中のサブスクに別のトライアル中の項目 `price_b` を追加する更新を行う場合:

| クラシック | フレキシブル |
| --- | --- |
| トライアル中の変更により、請求書が生成されないか、サブスクの全体の状態が再記載された請求書が生成されます。 | トライアル中の変更は常に、トライアル外の変更に匹敵する項目をもたらします。たとえば、新しい価格がサブスクに追加されると、その価格を表す項目も追加されます。 |

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

### 更新時に追加された 1 回限りの料金を請求

請求期間の途中でサブスクを更新する際、またはサブスクスケジュールのフェーズが移行する際に、add_invoice_items を使用して 1 回限りの料金のみを追加すると、proration_behavior=always_invoice の動作は請求モードによって異なります。この違いが適用されるのは、サブスク項目、価格、数量の変更によって Stripe で請求が作成されない場合のみです。

| **クラシック** | **フレキシブル** |
| --- | --- |
| Stripe で、追加された請求書項目を含む、更新に伴う請求が作成されます。 | Stripe で、保留中の請求書項目が作成されます。`proration_behavior=always_invoice` を設定するだけでは、更新に伴う請求はすぐには作成されません。保留中の項目は、サブスクの契約更新時の請求など、後で作成される対象の請求に含まれることがあります。 |

更新の別の部分によって Stripe で請求が作成される場合、サブスクを作成する場合、またはサブスクの更新時にスケジュールのフェーズが移行する場合、この違いは適用されません。

フレキシブル請求モードのサブスクで追加された項目を請求するには、次回のサブスクの請求まで待ちます。それより早く請求するには、更新またはフェーズの移行後に[請求を作成](https://docs.stripe.com/api/invoices/create.md)し、`subscription` をサブスク ID に設定します。この請求には、更新またはフェーズの移行時に追加された項目だけでなく、そのサブスクの保留中の請求書項目がすべて含まれます。

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

フレキシブル請求モードでは、`proration_behavior=always_invoice` であり、かつ `payment_behavior` が `pending_if_incomplete` に設定されていない更新によって生成される請求書に、利用可能なすべての保留中の請求書項目が含まれます。

| **クラシック** | **フレキシブル** |
| --- | --- |
| 請求サイクルの起点をリセットした際の請求書には、利用対象となる保留中の項目が含まれます。`proration_behavior=always_invoice` を指定して生成されたその他のすべての更新時の請求書では、更新自体によって日割り計算などの請求書項目が生成される場合、既存の保留中の項目は除外されます。 | フレキシブル請求モードでは、サブスクの更新によって請求書が生成される際に、対象となる保留中の請求書項目が含まれます。これには、`proration_behavior=always_invoice` を含む更新や、請求サイクルアンカーのリセットによる更新が含まれます。

`payment_behavior=pending_if_incomplete` を使用する更新は例外です。これらの請求書では、既存の保留中の請求書項目が除外されるためです。これらの項目は、後で請求するために保留されたままとなります。 |

## 同じサブスクでの間隔の混在

フレキシブル請求モードでは、[間隔が混在するサブスク](https://docs.stripe.com/billing/subscriptions/mixed-interval.md)を作成できます。これにより、間隔が異なる複数の継続価格について請求できます。その結果、1 つのサブスク内で異なる料金体系を組み合わせることができます。

| **クラシック** | **フレキシブル** |
| --- | --- |
| サポートされていません。サブスクのすべての項目は、同じ間隔と間隔のカウントを持つ価格である必要があります。 | [間隔が混在するサブスク](https://docs.stripe.com/billing/subscriptions/mixed-interval.md)の項目には、異なる間隔または間隔のカウントを持つ継続価格を含めることができます。たとえば、月次の価格と年次の価格を同じサブスクに共存させることができます。 |

## サブスク項目の上限

フレキシブル請求モードでは、従来の請求モードよりも多くのサブスク項目に対応しています。

| **クラシック** | **フレキシブル** |
| --- | --- |
| 最大 20 個のサブスク項目に対応しています。 | 最大 100 個のサブスク項目に対応しています。 |
