混在する請求間隔のサブスクリプションを解約するための補助ツールを追加
新機能
請求期間の終了時の異なる請求間隔を持つ サブスクリプションのキャンセルを簡素化するために、次の cancel_at 列挙値を導入しました。
min_: すべてのサブスクリプションアイテムで、最も早いperiod_ end items.のサブスクリプションのキャンセルをスケジュールします。data. current_ period_ end max_: すべてのサブスクリプションアイテムで、最新のperiod_ end items.にサブスクリプションのキャンセルをスケジュールします。data. current_ period_ end
サブスクリプションアイテムの current_ の両方を変更し、これらの新しい値のいずれかを設定するリクエストでは、更新された current_ がそれぞれのキャンセル日として使用されます。cancel_at_period_end とは異なり、これらの値はタイムスタンプに即座に解決され、items. に対する以降の変更はタイムスタンプに影響しません。
注
異なる請求間隔を持つサブスクリプションでは、既存の cancel_at_period_end 機能は常に最も早い項目の期間の終わりに解決されます。
効果
以下の API エンドポイントは、新しい列挙型をサポートしています。
現在、柔軟な請求モード（flexible billing mode）の統合で cancel_at_period_end を使用してサブスクリプションを解約している場合は、次のいずれかの方法で統合を更新してください。
- どのインターバルでキャンセルを実行するかを指定するために、新しい
min_またはperiod_ end max_の列挙値を使用してください。period_ end - cancel_at には、明示的な整数のタイムスタンプを設定してください。
サブスクリプションの cancel_ パラメータは、新しい cancel_ 補助機能（ヘルパー）とは互換性がありません。
サブスクリプション内のアイテムの current_ 値を更新する場合、同じリクエスト内で cancel_ または cancel_ を指定することで、サブスクリプションの既存の cancel_at タイムスタンプをリセットできます。