Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden

Entfernt nutzungsbasierte AbrechnungWichtige Änderungen

Das ändert sich

Wir haben die Unterstützung für ältere nutzungsbasierte Abrechnungen entfernt. Sie können keinen Preis mehr erstellen, dessen usage_type auf nutzungsbasiert gesetzt ist, ohne einen angegebenen Zähler. Außerdem wurden die billing_thresholds aus den Abo-Endpunkten entfernt.

Wir haben billing_thresholds und aggregate_usage von allen API-Endpoints entfernt. Sie können keine älteren nutzungsbasierten Preise mehr erstellen und keine bestehenden nutzungsbasierten Preise mehr an Angebote, anstehende Rechnungen oder Abonnements anhängen.

Ein älterer nutzungsbasierter Preis ist definiert als ein Preis mit dem usage_type metered ohne angegebenen Zähler.

Warum ist dies eine wichtige Änderung?

  • Billing_thresholds von Abo-Endpoints entfernt.
  • aggregate_usage aus Preis-Endpoints entfernt.
  • Die Verwendung von usage_type der nutzungsbasierten Messung ohne einen angegebenen Zähler gibt jetzt einen Fehler bei der Preiserstellung zurück.
  • Die Unterstützung für das Anhängen der Preise von usage_type=metered ohne festgelegten meter an Abonnements, Abonnementzeitpläne und Angebote wurde deaktiviert.

Ergebnis

Befolgen Sie unseren Migrationsleitfaden, um Ihre Integration so zu aktualisieren, dass Zähler verwendet werden.

Änderungen

ÄndernRessourcen
Entfernt
UsageRecordSummaryUsageRecord
Endpoints ÄndernRessourcen
createEntfernt
UsageRecord
listEntfernt
UsageRecordSummary
usage_record_summariesEntfernt
SubscriptionItem
ParameterÄndernRessourcen oder Endpoints
aggregate_usageEntfernt
Price.recurring
billing_thresholdsEntfernt
Subscription#create.items[]Subscription#createSubscription#update.items[]Subscription#updateSubscriptionItem#createSubscriptionItem#updateSubscriptionItemSubscriptionSchedule#create.default_settingsSubscriptionSchedule#create.phases[].items[]SubscriptionSchedule#create.phases[]SubscriptionSchedule#update.default_settingsSubscriptionSchedule#update.phases[].items[]SubscriptionSchedule#update.phases[]SubscriptionSchedule.default_settingsSubscriptionSchedule.phases[].items[]SubscriptionSchedule.phases[]Subscription

Upgrade

  1. Zeigen Sie Ihre aktuelle API-Version in Workbench an.
  2. Wenn Sie ein SDK verwenden, aktualisieren Sie auf die entsprechende SDK-Version für diese API-Version.
    • Wenn Sie kein SDK verwenden, aktualisieren Sie Ihre API-Anfragen auf Stripe-Version: 2025-03-31.basil
  3. Aktualisieren Sie die für Webhook-Endpoints verwendete API-Version.
  4. Testen Sie Ihre Integration mit der neuen Version.
  5. Wenn Sie Connect verwenden, testen Sie Ihre Connect-Integration.
  6. Führen Sie das Upgrade in Workbench durch. Sie können die Version für 72 Stunden zurücksetzen.

Erfahren Sie mehr über Stripe-API-Upgrades.

Zugehörige Änderungen