コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン
概要
バージョン管理
API バージョンのアップグレード
Essentials
ツール
Visual Studio Code をご利用の場合
機能
Stripe 健全性アラートファイルのアップロード
AI ソリューション
モデルコンテキストプロトコルエージェントを使用した AI SaaS 請求ワークフローの構築
セキュリティとプライバシー
Stripebot ウェブクローラー
Stripe を拡張する
パートナー
パートナー認定

注

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

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

新機能

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

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

We no longer support the iterations parameter for Subscription Schedules.

影響

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

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

前
後
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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

変更点

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

アップグレード

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

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

関連する変更

このページはお役に立ちましたか。
はいいいえ