Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellenAnmelden
Jetzt starten
Zahlungen
Umsatz
Plattformen und Marktplätze
Geldmanagement
Entwicklerressourcen
APIs und SDKsHilfe
Übersicht
Versionierung
Änderungsprotokoll
    Übersicht
    Clover
    Basil
    Acacia
    Vorherige Versionen
Aktualisieren Sie Ihre API-Version
Ihre SDK-Version aktualisieren
Essentials
SDKs
API
Tests
Stripe-CLI
Beispiel-Projekte
Tools
Stripe Dashboard
Workbench
Entwickler-Dashboard
Stripe Shell
Stripe für Visual Studio Code
Funktionen
Arbeitsabläufe
Ereignisziele
Stripe-StatuswarnungenHochgeladene Dateien
KI-Lösungen
Agent-Toolkit
Model Context ProtocolAgentische KI-SaaS-Billing-Workflows aufbauen
Sicherheit und Datenschutz
Sicherheit
Stripebot-Webcrawler
Datenschutz
Stripe erweitern
Erstellen Sie Stripe-Apps
Verwenden Sie Apps von Stripe
Partner
Partner-Ecosystem
Partner-Zertifizierung
Vereinigte Staaten
Deutsch
StartseiteEntwicklerressourcenChangelogBasil2025-05-28.preview

Fügt Zeitstempel-Hilfsprogramme für cancel_at in Abonnements hinzuÖffentliche Vorschau

Das ändert sich

Wir haben neue cancel_at-Enum-Werte für Abonnements eingeführt, die mit flexiblem Verhalten konfiguriert sind (bei denen billing_mode auf flexible gesetzt ist). Diese Änderung vereinfacht die Kündigung eines Abonnements am Ende eines Abrechnungszeitraums mit gemischten Intervallen.

Die neuen cancel_at-Enum-Werte lauten:

  • min_period_end
  • max_period_end

Verwenden Sie diese Werte, um den frühesten und neuesten items.data.current_period_end unter allen Abo-Posten zu kündigen.

Diese neuen Enum-Werte legen das Kündigungsdatum basierend auf items.data.current_period_end des aktuellen Abos fest. Im Gegensatz zu cancel_at_period_end werden diese Werte sofort in Zeitstempel umgewandelt und sind von späteren Änderungen an items.data.current_period_end nicht betroffen

Der Parameter cancel_at_period_end ist jetzt veraltet. Das Verhalten dieses Parameters bleibt unverändert, aber im Zusammenhang mit Abos mit gemischten Intervallen wird standardmäßig die Kündigung zum frühesten Periodenende durchgeführt.

Ergebnis

Die folgenden API-Endpoints unterstützen diese neuen Werte:

  • Ein Abonnement erstellen
  • Ein Abo aktualisieren
  • Vorschau einer Rechnung erstellen

Wenn Ihre Integration derzeit den veralteten Parameter cancel_at_period_end verwendet, um Abos zu kündigen, verwenden Sie stattdessen den neuen Parameter cancel_at mit dem Enum-Wert min_period_end. Das Feld cancel_at_period_end eines Abos ist nicht kompatibel mit den neuen cancel_at-Helfern.

Änderungen

FelderÄndernVon → bis
Invoice#create_preview.subscription_details.cancel_atSubscription#create.cancel_atSubscription#update.cancel_atGeändert
DateTime → DateTime | enum('max_period_end'|'min_period_end')DateTime → DateTime | enum('max_period_end'|'min_period_end')DateTime → DateTime | enum('max_period_end'|'min_period_end')

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-05-28.preview
  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

  • Fügt die Möglichkeit hinzu, Abonnements in den flexiblen Abrechnungsmodus zu migrieren
War diese Seite hilfreich?
JaNein
  • Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
  • Schauen Sie sich unser Änderungsprotokoll an.
  • Fragen? Sales-Team kontaktieren.
  • LLM? Lesen Sie llms.txt.
  • Unterstützt von Markdoc