サブスクリプションの期間終了時のキャンセルを柔軟に管理できるようになりました公開プレビュー
新規情報
柔軟な動作が設定されたサブスクリプション (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 パラメーターは非推奨になりました。このパラメーターの動作に変更はありませんが、混合期間のサブスクリプションの場合、デフォルトで最も早く到来する期間終了日にキャンセルされます。
影響
次の API エンドポイントは、以下の新しい値をサポートしています。
現在のシステムで、サブスクリプションのキャンセルに非推奨の cancel_at_period_end パラメーターが使用されている場合は、代わりに min_ 列挙値を含む新しい cancel_at パラメーターを使用してください。サブスクリプションの cancel_ フィールドは、新しい cancel_ ヘルパーと互換性がありません。