クーポンとプロモーションコードのパラメーターを削除互換性に関わる変更

新規情報

単数形の クーポンと promotion_code のパラメーターは削除され、複数の割引の適用をサポートする discounts パラメーターが使用されます。

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

discounts パラメーターを使用して、サブスクリプション、サブスクリプションスケジュール or プレビュー請求書に 1 つ以上の割引を含め、代わりに割引からレスポンスを読みます。

パラメーター	変更する	リソースまたはエンドポイント
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 のアップグレードについて、詳細をご確認ください。