事前請求

ライセンス料金の一般的な Billing サイクルでは顧客に 1 つのサービス期間分を請求しますが、事前請求では複数のサービス期間分を事前に顧客に請求できます。サブスクリプションの開始時や次回の更新時に事前請求を有効にできます。

事前請求のユースケースの例を次に示します。

• 月次サブスクリプションを作成し、最初の 45 日間を事前請求します。
• 月次サブスクリプションの更新が 7 日後に行われる場合は、今すぐ事前請求して更新請求書を顧客に送信します。
• 更新時から今後 2 カ月間を事前請求します。

事前請求は、サブスクリプションを作成または更新するときに使用できます。事前請求は項目レベルで適用され、特定の項目、一連の項目、またはサブスクリプションのすべての項目に対して事前請求できます。事前請求の期間範囲は項目レベルで調整できますが、少なくとも 1 つのサービス期間をカバーする必要があります。たとえば、月額料金の項目を事前請求する場合は、少なくとも 1 カ月間事前請求する必要があります。

制限事項

パブリックプレビュー中、事前請求には次の制限があります。

• サブスクリプションスケジュールやサブスクリプションスケジュールに関連付けられたサブスクリプションでは事前請求を使用できません。
• 事前請求では、percent_off と duration が once または forever に設定されたクーポンのみを使用できます。
• サブスクリプションを作成または更新し、billing_schedules を設定すると、事前請求が即座に適用されます。
• 従来の Billing モードから Flexible Billing モードに移行したサブスクリプションでは事前請求を使用できません。
• すべてのサブスクリプションアイテムに使用量ベースの価格が設定されている場合、事前請求を有効にすることはできません。サブスクリプションの使用量ベースの価格には事前請求は適用されません。価格に usage_type=metered が設定されている場合は、applies_to[price] を設定できません。
• サブスクリプションで事前請求を使用するには、比例配分を有効にする必要があります。proration_behavior を none に設定することはできません。
• キャンセルがスケジュールされているサブスクリプションを更新する場合、事前請求はスケジュールされたキャンセル時刻までのみ有効にできます。
• payment_behavior が pending_if_incomplete に設定されている場合は、事前請求を使用できません。

はじめに

事前請求を使用するには、以下を行う必要があります。

• Flexible Billing モードを有効にしてサブスクリプションを作成します。Flexible Billing モードの詳細をご確認ください。
• Stripe API バージョン 2025-09-30.preview 以降を導入しています。API バージョンのアップグレード方法をご確認ください。

事前請求を設定する

事前請求は、ダッシュボードまたは API でサブスクリプションを作成または更新するときに有効にできます。

事前請求の終了日を設定する場合

• 終了日は、サブスクリプションの最短請求期間の開始日より前にすることはできません。たとえば、サブスクリプションの最短請求期間が月次である場合、事前請求の終了日は請求期間の開始から少なくとも 1 カ月である必要があります。
• 終了日は、サブスクリプションの最短請求期間の 12 サイクルの終了日より後にすることはできません。たとえば、サブスクリプションの最短請求期間が月次である場合、事前請求の終了日は請求期間の開始から 12 カ月以内にする必要があります。