サブスクリプションスケジュールの反復パラメーターを削除互換性に関わる変更

新機能

iterations パラメーターを削除しました。duration がその機能を代替します。

以下の API エンドポイントでは、iterations パラメータを使用してサブスクリプションスケジュールのフェーズの長さを指定することができなくなりました。

iterations の代わりに duration を使用して、サブスクリプションスケジュールを作成または更新してください。

パラメーター	変更する	リソースまたはエンドポイント
iterations	削除済み	Invoice#create_preview.schedule_details.phases[]SubscriptionSchedule#create.phases[]SubscriptionSchedule#update.phases[]

Workbench で現在の API バージョンを表示します。
SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。
- SDK を使用していない場合は、Stripe-Version: 2025-08-27.preview を含めるように API リクエストを更新してください。
Webhook エンドポイントに使用する API バージョンをアップグレードします。
新しいバージョンに対して、実装内容をテストします。
Connect を使用する場合は、Connect の実装内容をテストします。
Workbench でアップグレードを実行します。バージョンをロールバックできるのは 72 時間以内です。

Stripe API のアップグレードについて、詳細をご確認ください。