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

サブスクリプションを遡及適用する方法をご紹介します。

サブスクリプションを遡及適用して、すでに経過した期間分を顧客に請求できます。Stripe に移行する際や、または記録保持のためによく使用されます。backdate_start_date フィールドは、サブスクリプションの遡及適用の開始日を指定します。また、必要に応じて経過した期間部分を顧客に請求したり、次回の請求日を設定したりすることもできます。

請求モードに関する考慮事項

API バージョン 2025-04-30 では、遡及適用の動作はサブスクリプションの billing_mode によって異なります。

前

後

billing_mode=classic を使用すると、遡及適用期間の日数で比例配分された単一の項目が作成されます。

billing_mode=flexible を使用して、遡及期間に発生した自然請求期間ごとに 1 つの項目を生成します。これは通常の請求と同様に動作します。

注

請求書の項目がデフォルトの上限である 250 件を超える場合、遡及適用はサポートされません。

遡及適用およびユーザへの請求

サブスクリプションが作成される前に、ユーザーがお客様のサービスにアクセスできる場合、そのアクセスに対してユーザーに請求するとします。

ダッシュボードでこの期間をユーザーに請求するには、以下のようにします。

支払い > サブスクリプションページに移動します。
+サブスクリプションを作成するをクリックします。
顧客を検索または追加します。
価格と商品情報を入力します。
サブスクリプションの詳細セクションで、サブスクリプションの開始日と終了日を選択します。遡及適用するには、開始日を過去の日付にします。
請求期間を開始する日付を選択します。
(任意) 支払いまたは詳細設定オプションを設定します。
サブスクリプションを作成をクリックします。サブスクリプションは選択した日付に開始されます。

これにより、遡及適用の開始日から現在までの期間の料金が記載された請求書が作成されます。

サブスクリプションに billing_mode=classic が設定されている場合、Stripe は、遡及開始日からの想定期間に基づいて、遡及期間の比例配分額を 1 つ作成します。たとえば、月初からの請求期間があり、backdate_start_date を (うるう年以外の) 2 月 15 日に設定すると、Stripe は 2 月 15 日から 3 月 15 日までの想定月を基準に比例配分を計算します。2 月の日数は 28 日であるため、2 月 15 日から 3 月 1 日までの 14 日間の比例配分額は、通常の月次請求の金額のちょうど半分になります。

同様に、backdate_start_date を 1 月 15 日に設定した場合、Stripe は 1 月 15 日から 2 月 15 日までの 1 カ月を基準にして比例配分を計算します。この月の日数は 31 日であるため、1 月 15 日から 2 月 1 日までの 17 日間の比例配分額は、通常の月額料金の 31 分の 17 (約 0.548) となります。

また、遡及適用の開始日を基の開始日と見なして計算を表示することも可能です。その後、最初の請求期間の開始日が更新された開始日になります。

サブスクリプションに billing_mode=flexible が設定されている場合、Stripe は、遡及期間に発生した自然請求期間ごとに個別の項目を生成します。つまり、各期間は、Stripe がその期間に通常請求したかのように処理されます。

ユーザへの請求を行わない遡及適用

遡及適用された期間について顧客に請求せず、サブスクリプションを遡及適用することもできます。この方法は、Stripe に移行する場合に使用できます。そのためには、サブスクリプションの作成時に proration_behavior: 'none' を渡します。この結果、start_date が backdate_start_date と同じ値に設定されますが、遡及適用された期間について顧客への請求は行われません。

遡及適用と請求サイクルアンカーの設定

backdate_start_date と billing_cycle_anchor を組み合わせてサブスクリプションに遡及適用し、請求サイクルアンカーを将来の日付に設定します。これにより、遡及適用された開始日と請求サイクルアンカーの間の比例配分されたアイテムが、次回の請求書に作成されます。これは、Stripe に移行中で、サブスクリプションの次の請求日を繰り越す一方で、経過した期間について顧客に請求する必要がある場合に使用できます。

たとえば、現在 10 月 15 日で、Stripe に移行中だと仮定します。9 月 1 日に開始したサブスクリプションがあり、次回の請求日は 11 月 1 日です。このサブスクリプションを移行するには、新しいサブスクリプションを作成し、backdate_start_date を 9 月 1 日に、billing_cycle_anchor を 11 月 1 日に設定します。

これにより、9 月 1 日から 11 月 1 日までの比例配分を適用した金額の請求書が即時に発行されます。また、サブスクリプションの start_date は 9 月 1 日に設定されます。Stripe は次の請求書を 11 月 1 日に発行します。

更新の遡及適用

定期購入の更新時に日割り計算の有効日を設定するには、proration_date パラメーターを使用します。サブスクリプション項目の現在の期間内で発生する整数の Unix タイムスタンプを渡します。サブスクリプションでサブスクリプションスケジュールが使用されている場合は、タイムスタンプがスケジュールの次のフェーズの開始日より前であることを確認してください。

過去のサブスクリプションの最初の期間のみ、現在の期間より前の proration_date を設定できます。この場合、proration_date は subscription[start_date] (遡及適用の開始日) 以降にする必要があります。それ以外の場合、proration_date を current_period_start より前にすることはできません。