レガシーの従量課金を廃止しました互換性に関わる変更

新規情報

レガシーの従量課金のサポートを終了しました。meter を指定せずに、metered の usage_type を持つ price を作成できなくなりました。また、subscription エンドポイントから billing_thresholds を削除しました。

すべての API エンドポイントから billing_thresholds と aggregate_usage を削除しました。今後は、レガシーの従量制料金を作成することも、既存の料金を見積もり、次回請求書、またはサブスクリプションに関連付けることもできません。

レガシーの従量制料金とは、meter が指定されておらず、metered の usage_type を持つ価格を指します。

Subscription (サブスクリプション) エンドポイントから billing_thresholds を削除しました。
Price (価格) エンドポイントから aggregate_usage を削除しました。
meter を指定せずに metered の usage_type を使用すると、Price (価格) の作成時にエラーが返されるようになりました。
meter を設定せずに usage_type=metered の価格を Subscription、Subscription Schedule、Quotes に関連付けられなくなりました。

移行ガイドに従って、メーターを使用するようにシステムを更新してください。

	変更する	リソース
	削除済み	UsageRecordSummary UsageRecord
エンドポイント	変更する	リソース
create	削除済み	UsageRecord
list	削除済み	UsageRecordSummary
usage_record_summaries	削除済み	SubscriptionItem
パラメーター	変更する	リソースまたはエンドポイント
aggregate_usage	削除済み	Plan#create Plan`Price#create.recurring` + さらに 1 件 `Price.recurring`
billing_thresholds	削除済み	Invoice#create_preview.schedule_details.phases[].items[]Invoice#create_preview.schedule_details.phases[]Invoice#create_preview.subscription_details.items[] + さらに 17 件 Subscription#create.items[]Subscription#create Subscription#update.items[]Subscription#update SubscriptionItem#create SubscriptionItem#update SubscriptionItem SubscriptionSchedule#create.default_settings SubscriptionSchedule#create.phases[].items[]SubscriptionSchedule#create.phases[]SubscriptionSchedule#update.default_settings SubscriptionSchedule#update.phases[].items[]SubscriptionSchedule#update.phases[]SubscriptionSchedule.default_settings SubscriptionSchedule.phases[].items[]SubscriptionSchedule.phases[]Subscription

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

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