クーポンとプロモーションコードのパラメーターを削除破壊的変更

新規情報

単数形のcoupon パラメーターと promotion_code パラメーターを削除し、今後は複数の割引の適用をサポートする discounts パラメーターを使用します。

coupon と promotion_code のパラメーターとフィールドは、Subscription (サブスクリプション)、Subscription Schedule (サブスクリプションスケジュール)、Customer (顧客)、Preview Invoice (請求書プレビュー) エンドポイントおよびそれぞれのリソースで使用できなくなりました。

Subscription (サブスクリプション)、Subscription Schedule (サブスクリプションスケジュール)、または Preview Invoice (請求書プレビュー) に 1 つ以上の割引を含めるには discounts パラメーターを使用します。discounts はレスポンスから読み取るようになります。

パラメーター	変更する	リソースまたはエンドポイント
coupon	削除済み	Invoice#create_preview.schedule_details.phases[]Invoice#create_preview Subscription#create + さらに 6 件 Subscription#update SubscriptionSchedule#create.phases[]SubscriptionSchedule#update.phases[]SubscriptionSchedule.phases[]Customer#create Customer#update
discount	削除済み	Invoice Subscription
promotion_code	削除済み	Subscription#create Subscription#update Customer#create + さらに 1 件 Customer#update

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

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