Checkout で請求サイクル日を設定する
Checkout でサブスクリプションの請求サイクルアンカーを固定日 (翌月 1 日など) に明示的に設定できます。
請求サイクルの起点は、顧客にサブスクリプションの全額が請求される最初の請求書の日付を決定します。請求サイクルの起点とその価格の継続期間によって、サブスクリプションの今後の請求日も決定されます。たとえば、Checkout で 5 月 15 日に月次サブスクリプションを作成して、6 月 1 日の起点を指定すると、5 月 15 日に請求され、その後は常に毎月 1 日に請求されます。
全額が請求される最初の請求書の日付までの請求期間について、proration_behavior パラメーターを使用して、比例配分 (日割り / 秒割り計算) を処理する方法をカスタマイズできます。デフォルトでは、proration_behavior
は create_prorations に設定されており、顧客は比例配分が適用された請求書を受け取ります。proration_behavior
が none の場合、顧客は全額が請求される最初の請求書の日付までの期間を無料で使用できます。
請求サイクルアンカーを指定して Checkout セッションを作成する
請求サイクルの起点を設定するには、subscription
モードで Checkout セッションを作成するときに、subscription_data.billing_cycle_anchor
パラメーターを設定します。
アンカーは、通常の次回のサブスクリプションの請求日より前の将来の Unix タイムスタンプにする必要があります。
請求サイクルアンカーがセッションの有効な期間内であり、顧客がその期間を過ぎてから支払おうとした場合、Checkout は、請求サイクルアンカーまでの比例配分が適用された期間ではなく、請求サイクルアンカーから始まる期間全体を表示して請求します。
比例配分の無効化
比例配分を無効にするには、Checkout セッションを作成する際に subscription_data.proration_behavior
パラメーターを none に設定します。
無料トライアルと同様に、請求サイクルの起点までの最初の期間は無料です。トライアルと異なる点は、0 USD のインボイスが生成されないことです。顧客は、請求サイクルの起点の日付にサブスクリプションの全額の請求書を受け取ります。
比例配分を無効にすると、Checkout セッションの応答オブジェクトで、line items と total details に関連付けられている金額が常に 0 になります。また、決済が将来の日付に先送りされることを反映してセッションの payment status が no_payment_required
に設定されます。
現在の制限事項
- Checkout では請求サイクルアンカーを指定してトライアルを使用することはできません。
proration_behavior
が none の場合、Checkout セッションでは 1 回限りの価格は使用できません。- create_prorations のデフォルトの
proration_behavior
が指定された Checkout セッションにamount_off
coupons を適用することはできません。