レガシーの従量課金を廃止しました破壊的変更

新規情報

レガシーの従量課金のサポートを終了しました。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

View your current API version in Workbench.
If you use an SDK, upgrade to the corresponding SDK version for this API version.
- If you don’t use an SDK, update your API requests to include Stripe-Version: 2025-03-31.basil
Upgrade the API version used for webhook endpoints.
Test your integration against the new version.
If you use Connect, test your Connect integration.
In Workbench, perform the upgrade. You can roll back the version for 72 hours.