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

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

希望する請求モードを設定して、ビジネス要件を満たすように請求書とサブスクリプションを調整できます。各サブスクリプションは、次の 2 つの請求モードのいずれかを使用するように設定できます。

柔軟推奨: 正確で予測可能な請求動作を提供し、新しい機能を利用できるようになります。これらの改善は柔軟な請求モードでのみ利用できるため、新しいサブスクリプションを柔軟な請求モードで作成するか、既存のサブスクリプションを移行する必要があります。
クラシック: 既存の Stripe サブスクリプション動作を使用します。この設定は、古い統合との下位互換性のために維持されます。

従来の請求モードと柔軟な請求モードの詳細な違いと、最適な請求モードの選び方について詳しく説明します。

柔軟な請求モードを選ぶ理由

柔軟な請求モードは、比例配分、使用状況ベースの料金体系、柔軟な請求、トライアル設定の請求の精度を高めます。また、同じサブスクリプションに混在期間を設定するなど、新機能も利用できるようになります。これらの改善は柔軟な請求モードでのみ利用できるため、柔軟な請求モードを使用して新しいサブスクリプションを作成し、既存のサブスクリプションを移行することをお勧めします。

請求の新規ユーザーは、サブスクリプションと請求書に柔軟な請求モードを使用することをお勧めしますが、必須ではありません。

既存のユーザーの場合、現在の実装との下位互換性を維持するために、デフォルトの請求モードは従来のまま保持されます。ただし、最新の請求機能と改善点を活用するには、柔軟な請求モードに移行することをお勧めします。従来の請求モードと柔軟な請求モードの違いについて、詳細をご確認ください。

柔軟な請求モードを始める

サブスクリプションの作成時や移行時に、API またはダッシュボードを使用して請求モードを設定または更新できます。指定しない場合、デフォルトの請求モードが適用されます。

API を使用してサブスクリプションを作成または更新する場合、請求モードのデフォルト値は API 実装バージョンによって異なります。
ダッシュボード (Payment Links および Pricing Tables を含む) でサブスクリプションを作成または更新する場合、デフォルト値は、設定 > 請求 > サブスクリプションとメール で設定した請求モードのデフォルト設定によって異なります。

柔軟な請求モードを使用するには、Stripe API バージョン 2025-06-30.basil 以降で実行されているシステムが必要です。API バージョンをアップグレードする方法をご覧ください。

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

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

サブスクリプションエディターを使用して柔軟な請求モードのサブスクリプションを作成するには、以下のステップに従います。

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

請求モードのデフォルト値は、アカウント設定によって異なります。詳細設定 で、設定 > 請求 > サブスクリプションとメール の請求モードのデフォルト設定を設定することにより、表示される請求モードのオプションとデフォルトの選択内容をカスタマイズできます。サブスクリプションエディターでは、以下から請求モードのオプションを表示できます。

クラシック: 柔軟な請求モードと従来の請求モードの両方が表示され、デフォルトで従来のモードが選択されます。実装が従来の請求モードに依存しており、まだ柔軟な請求に移行できない場合には、このオプションをお勧めします。
柔軟: 柔軟な請求モードと従来の請求モードの両方が表示され、デフォルトで柔軟なモードが選択されています。このオプションは、柔軟な請求モードに積極的に移行する場合にお勧めします。
柔軟でクラシックを非表示: サブスクリプションエディターには、柔軟な請求モードのみが表示されます。このオプションは、Stripe 請求の新規ユーザーと、柔軟な請求モードのみを使用する既存のユーザーに推奨されます。

ダッシュボード請求モードの設定

請求モードのデフォルト設定では、ダッシュボードで生成された Payment Links と料金表を使用して作成されたサブスクリプションの請求モードも決定されます。たとえば、請求モードのデフォルト設定を柔軟に設定し、ダッシュボードで Payment Link を作成した場合、その Payment Link から生成されたサブスクリプションはすべて柔軟な請求モードを使用します。

請求モードのデフォルト設定は、ダッシュボードで作成された新しいサブスクリプションにのみ適用されます。API を使用して作成されたサブスクリプションや、柔軟なモードに移行したサブスクリプションには影響しません。

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

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

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

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

請求モードとサブスクリプションスケジュール

既存のサブスクリプションからサブスクリプションスケジュールを作成する際、そのサブスクリプションにすでに存在している場合は、billing_mode を設定しないでください。スケジュールは、元のサブスクリプションの billing_mode を自動的に継承します。from_subscription を使用するときに billing_mode を設定すると、Stripe はエラーを返します。別の billing_mode が必要な場合は、新しいサブスクリプションを作成します。

比例配分割引の項目別設定

柔軟なサブスクリプションを使用している場合は、請求書とインボイスアイテムに比例配分割引の優先動作を設定できます。

項目別 推奨: 請求書とインボイスアイテムに、比例配分を適用した総額と正確な割引額を、非比例配分と一貫した形式で表示できます。
包含: 正味金額と割引金額ゼロの既存の Stripe 比例配分表示動作を使用します。この設定は、以前の統合との下位互換性のために維持されます。

項目別と包含の違いの詳細をご確認ください。

項目別の比例配分割引を有効にするには、API バージョンを 2025-06-30.basil 以降にアップグレードする必要があります。

サブスクリプションを作成または移行して、proration_discounts を itemized に設定します。

上記のコード例では、以下のレスポンスが返されます。

{
  "id": "sub_JgRjFjhKbtD2qz",
  "object": "subscription",
  "billing_mode": {
    "flexible": {
      "proration_discounts": "itemized"
    },
    "type": "flexible",
    "updated_at": 1751071020
  },