# サブスクリプションスケジュールの反復パラメータを削除します。

## 新機能

[iterations](https://docs.stripe.com/api/subscription_schedules/create.md?api-version=2025-09-30.clover#create_subscription_schedule-phases-iterations) パラメーターを削除しました。[duration](https://docs.stripe.com/api/subscription_schedules/create.md?api-version=2025-09-30.clover#create_subscription_schedule-phases-duration) がその機能を代替します。

## なぜこれは、互換性に関わる変更なのでしょうか？

[サブスクリプションスケジュール](https://docs.stripe.com/api/subscription_schedules/create.md?api-version=2025-09-30) の [iterations](https://docs.stripe.com/api/subscription_schedules/create.md?api-version=2025-09-30.clover#create_subscription_schedule-phases-iterations) パラメーターには対応しなくなりました。

## 影響

次の API エンドポイントでサブスクリプションスケジュールフェーズの長さを指定するには、`duration` を使用するように統合を更新する必要があります。

- [サブスクリプションスケジュールの作成](https://docs.stripe.com/api/subscription_schedules/create.md?api-version=2025-09-30.clover)
- [サブスクリプションスケジュールの更新](https://docs.stripe.com/api/subscription_schedules/update.md?api-version=2025-09-30.clover)
- [請求書プレビューを作成する](https://docs.stripe.com/api/invoices/create_preview.md?api-version=2025-09-30.clover)

これらのエンドポイントで `iterations` を使用するとエラーが返されるようになりました。

### Before

```curl
curl https://api.stripe.com/v1/subscription_schedules \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2025-08-27.basil" \
  -d customer={{CUSTOMER_ID}} \
  -d start_date=now \
  -d "phases[0][items][0][price]={{PRICE_PREMIUM}" \
  -d "phases[0][items][0][quantity]=1" \
  -d "phases[0][iterations]=3" \
  -d end_behavior=release
```

### After

```curl
curl https://api.stripe.com/v1/subscription_schedules \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d customer={{CUSTOMER_ID}} \
  -d start_date=now \
  -d "phases[0][items][0][price]={{PRICE_PREMIUM}" \
  -d "phases[0][items][0][quantity]=1" \
  -d "phases[0][duration][interval]=month" \
  -d "phases[0][duration][interval_count]=3" \
  -d end_behavior=release
```

## 変更点

#### REST API

| Parameter | Change | Resources or endpoints |
| --- | --- | --- |
| `iterations` | Removed | [Invoice#create_preview.schedule_details.phases[]](/api/invoices/create_preview?api-version=2025-09-30.clover#create_invoice-schedule_details-phases), [SubscriptionSchedule#create.phases[]](/api/subscription_schedules/create?api-version=2025-09-30.clover#create_subscription_schedule-phases), [SubscriptionSchedule#update.phases[]](/api/subscription_schedules/update?api-version=2025-09-30.clover#update_subscription_schedule-phases) |

#### Ruby

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `iterations` | Removed | [Invoice::CreatePreviewParams::ScheduleDetail::Phase](/api/invoices/create_preview?api-version=2025-09-30.clover#create_invoice-schedule_details-phases), [SubscriptionSchedule::CreateParams::Phase](/api/subscription_schedules/create?api-version=2025-09-30.clover#create_subscription_schedule-phases), [SubscriptionSchedule::UpdateParams::Phase](/api/subscription_schedules/update?api-version=2025-09-30.clover#update_subscription_schedule-phases) |

#### Python

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `iterations` | Removed | [Invoice.CreatePreviewParamsScheduleDetailPhase](/api/invoices/create_preview?api-version=2025-09-30.clover#create_invoice-schedule_details-phases), [SubscriptionSchedule.CreateParamsPhase](/api/subscription_schedules/create?api-version=2025-09-30.clover#create_subscription_schedule-phases), [SubscriptionSchedule.ModifyParamsPhase](/api/subscription_schedules/update?api-version=2025-09-30.clover#update_subscription_schedule-phases) |

#### PHP

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `iterations` | Removed | [Invoice.create_preview().$params.schedule_detail.phase](/api/invoices/create_preview?api-version=2025-09-30.clover#create_invoice-schedule_details-phases), [SubscriptionSchedule.create().$params.phase](/api/subscription_schedules/create?api-version=2025-09-30.clover#create_subscription_schedule-phases), [SubscriptionSchedule.update().$params.phase](/api/subscription_schedules/update?api-version=2025-09-30.clover#update_subscription_schedule-phases) |

#### Java

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `iterations` | Removed | [InvoiceCreatePreviewParams.schedule_details.phases[]](/api/invoices/create_preview?api-version=2025-09-30.clover#create_invoice-schedule_details-phases), [SubscriptionScheduleCreateParams.phases[]](/api/subscription_schedules/create?api-version=2025-09-30.clover#create_subscription_schedule-phases), [SubscriptionScheduleUpdateParams.phases[]](/api/subscription_schedules/update?api-version=2025-09-30.clover#update_subscription_schedule-phases) |

#### Node.js

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `iterations` | Removed | [InvoiceCreatePreviewParams.schedule_details.phases[]](/api/invoices/create_preview?api-version=2025-09-30.clover#create_invoice-schedule_details-phases), [SubscriptionScheduleCreateParams.phases[]](/api/subscription_schedules/create?api-version=2025-09-30.clover#create_subscription_schedule-phases), [SubscriptionScheduleUpdateParams.phases[]](/api/subscription_schedules/update?api-version=2025-09-30.clover#update_subscription_schedule-phases) |

#### Go

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `Iterations` | Removed | [InvoiceCreatePreviewScheduleDetailsPhaseParams](/api/invoices/create_preview?api-version=2025-09-30.clover#create_invoice-schedule_details-phases), [SubscriptionSchedulePhaseParams](/api/subscription_schedules/create?api-version=2025-09-30.clover#create_subscription_schedule-phases) |

#### .NET

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `Iterations` | Removed | [InvoiceScheduleDetailsPhaseOptions](/api/invoices/create_preview?api-version=2025-09-30.clover#create_invoice-schedule_details-phases), [SubscriptionSchedulePhaseOptions](/api/subscription_schedules/create?api-version=2025-09-30.clover#create_subscription_schedule-phases) |

## アップグレード

#### REST API

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。
   - SDK を使用していない場合は、`Stripe-Version: 2025-09-30.clover` を含めるように [API リクエスト](https://docs.stripe.com/api/versioning.md)を更新してください。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Ruby

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Ruby SDK を [v16.0.0](https://github.com/stripe/stripe-ruby/releases/tag/v16.0.0)にアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Python

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Python SDK を [v13.0.1](https://github.com/stripe/stripe-python/releases/tag/v13.0.1)にアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### PHP

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. PHP SDK を [v18.0.0](https://github.com/stripe/stripe-php/releases/tag/v18.0.0)にアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Java

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Java SDK を [v30.0.0](https://github.com/stripe/stripe-java/releases/tag/v30.0.0)にアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Node.js

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Node SDK を [v19.1.0](https://github.com/stripe/stripe-node/releases/tag/v19.1.0)にアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Go

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Go SDK を [v83.0.0](https://github.com/stripe/stripe-go/releases/tag/v83.0.0)にアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### .NET

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. .NET SDK を [v49.0.0](https://github.com/stripe/stripe-dotnet/releases/tag/v49.0.0)にアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

## 関連する変更

- [プロモーションコードが、プロモーション用の多態性フィールドを使用してクーポンを参照するようになりました](https://docs.stripe.com/changelog/clover/2025-09-30/polymorphic-coupon.md)
- [割引ソースプロパティを追加して、割引クーポンプロパティを削除する](https://docs.stripe.com/changelog/clover/2025-09-30/add-discount-source-property.md)
- [フレキシブル請求モードを新しいサブスクリプションのデフォルトにする](https://docs.stripe.com/changelog/clover/2025-09-30/billing-mode-default-flexible.md)
- [請求サイクルのアンカー変更を考慮し、サブスクリプションスケジュールのフェーズ終了日の計算を更新](https://docs.stripe.com/changelog/clover/2025-09-30/billing-cycle-anchor-resets-during-phase-computation.md)
- [カスタマーポータル設定にトライアル動作を追加](https://docs.stripe.com/changelog/clover/2025-09-30/customer-portal-trial-behavior.md)
- [比例配分割引額を明細化する機能を追加](https://docs.stripe.com/changelog/clover/2025-09-30/itemize-proration-discount-amounts.md)