サブスクリプションの期間終了時のキャンセルを柔軟に管理できるようになりました公開プレビュー
新規情報
柔軟な動作が設定されたサブスクリプション (billing_mode が flexible のサブスクリプション) に新しい cancel_at 列挙値を導入しました。この変更により、混合期間のサブスクリプションは請求期間終了時にキャンセルしやすくなります。
新しい cancel_at 列挙値は次のとおりです。
min_period_ end max_period_ end
これらの値を使用すると、すべてのサブスクリプション項目の中で、最も早いまたは最も遅い items.data.current_period_end の時点でキャンセルできます。
これらの新しい列挙値は、現在のサブスクリプションのitems.に基づいてキャンセル日を設定します。cancel_at_period_endとは異なり、これらの値は即座にタイムスタンプに解決され、items.に対する以降の変更の影響を受けません。
cancel_at_period_end パラメーターは非推奨になりました。このパラメーターの動作に変更はありませんが、Mixed Interval サブスクリプションのコンテキストでは、デフォルトで最も早い期間の終了時にキャンセルされます。
影響
次の API エンドポイントは、以下の新しい値をサポートしています。
統合で現在、非推奨の cancel_at_period_end パラメーターを使用してサブスクリプションをキャンセルしている場合は、代わりに min_ 列挙値を指定して新しい cancel_at パラメーターを使用してください。サブスクリプションの cancel_ フィールドは、新しい cancel_ ヘルパーと互換性がありません。