混在する請求間隔のサブスクリプションを解約するための補助ツールを追加
新機能
請求期間の終了時の異なる請求間隔を持つ サブスクリプションのキャンセルを簡素化するために、次の 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. に対する以降の変更はタイムスタンプに影響しません。
メモ
Mixed Interval Subscriptions の場合、既存の cancel_at_period_end 機能は常に、最も早い項目の期間の終わりに解決されます。
効果
以下の API エンドポイントは、新しい列挙型をサポートしています。
フレキシブル請求モードの統合で現在 cancel_at_period_end を使用してサブスクリプションをキャンセルしている場合は、統合を以下のいずれかに更新します。
- どのインターバルでキャンセルを実行するかを指定するために、新しい
min_またはperiod_ end max_の列挙値を使用してください。period_ end - cancel_at に明示的な整数タイムスタンプを入力します。
サブスクリプションの cancel_ パラメータは、新しい cancel_ 補助機能（ヘルパー）とは互換性がありません。
サブスクリプション内の各項目の current_ 値を更新する場合、同じリクエスト内で cancel_ または cancel_ を指定することで、サブスクリプションの既存の cancel_at タイムスタンプをリセットできます。
メモ
この変更は、.NET SDKではバージョン49.まで、Java SDKではバージョン30.まで利用できません。れらのバージョンが利用可能になるまでは、ドキュメントに記載されていないパラメーターを送信する手順に従って、新しい列挙値をcancel_パラメーターに渡してください。