Fügt Unterstützung für polymorphe Objekte für den Abrechnungsmodus hinzuWichtige Änderungen

Das ändert sich

Wir haben den Parameter billing_mode und das Feldformat für alle Abrechnungs-Endpoints vereinheitlicht. Der Parameter billing_mode verwendet jetzt ein einheitliches Objektformat mit einem type-Feld und ersetzt das vorherige Zeichenfolgenformat. Außerdem haben wir das Feld billing_mode_details in das Hauptobjekt billing_mode konsolidiert.

Warum ist dies eine wichtige Änderung?

Der Parameter und das Feld billing_mode akzeptieren jetzt keinen Zeichenfolgenwert mehr (classic oder flexible), sondern erfordern nun ein Objekt mit einem type-Feld (zum Beispiel {type: 'flexible'}). Darüber hinaus wurde das separate Feld billing_mode_details entfernt, und seine Eigenschaft updated_at ist jetzt direkt im billing_mode-Objekt enthalten.

Ergebnis

Sie müssen Ihre Integration aktualisieren, wenn Sie derzeit den Parameter billing_mode verwenden oder auf das Feld billing_mode in API-Antworten zugreifen.

Vor:

{
  "billing_mode": "flexible",
  "billing_mode_details": {
    "updated_at": 1234567890
  }
}

Nach:

{
  "billing_mode": {
    "type": "flexible",
    "updated_at": 1234567890
  }
}

Diese Änderung betrifft die folgenden API-Endpoints und -Ressourcen:

Änderungen

Parameter	Ändern	Ressourcen oder Endpoints
billing_mode_details	Entfernt	Subscription
Felder	Ändern	Von → bis
Checkout.Session#create.subscription_data.billing_modeInvoice#create_preview.schedule_details.billing_modeInvoice#create_preview.subscription_details.billing_modeQuote#create.subscription_data.billing_modeQuote.subscription_data.billing_modeSubscription#create.billing_modeSubscriptionSchedule#create.billing_mode	Geändert	`enum('classic'\|'flexible') → billing_mode`
Quote.subscription_data.billing_modeQuotePreviewSubscriptionSchedule.billing_modeSubscription.billing_modeSubscriptionSchedule.billing_mode	Geändert	`optional → required`
QuotePreviewSubscriptionSchedule.billing_modeSubscription.billing_modeSubscriptionSchedule.billing_mode	Geändert	`enum('classic'\|'flexible') → SubscriptionsResourceBillingMode`
Subscription#migrate.billing_mode	Geändert	`literal('flexible') → billing_mode_migrate`

Upgrade

Zeigen Sie Ihre aktuelle API-Version in Workbench an.
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-06-30.preview
Aktualisieren Sie die für Webhook-Endpoints verwendete API-Version.
Testen Sie Ihre Integration mit der neuen Version.
Wenn Sie Connect verwenden, testen Sie Ihre Connect-Integration.
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.