Weiter zum Inhalt
Konto erstellen
oder
anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellen
Anmelden
Jetzt starten
Zahlungen
Umsatz
Plattformen und Marktplätze
Geldmanagement
Entwickler-Tools
Übersicht
Versionierung
Änderungsprotokoll
    Übersicht
    Basilikum
    Acacia
    Vorherige Versionen
Aktualisieren Sie Ihre API-Version
Ihre SDK-Version aktualisieren
Entwickler-Tools
SDKs
API
Tests
Workbench
Ereignisziele
Arbeitsabläufe
Stripe-CLI
Stripe Shell
Entwickler-Dashboard
Agent-Toolkit
Mit LLMs entwickelnStripe für Visual Studio CodeStripe-StatuswarnungenHochgeladene Dateien
Sicherheit und Datenschutz
Sicherheit
Datenschutz
Extend Stripe
Stripe-Apps
Stripe Connectors
Partner
Partner-Ecosystem
Partner-Zertifizierung
StartseiteEntwickler-ToolsChangelogBasil2025-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 den frühesten items.data.current_period_end für alle Abonnementposten zu stornieren.

Mit diesen neuen Enum-Werten wird das Kündigungsdatum basierend auf dem items.data.current_period_end des aktuellen Abonnements festgelegt. Im Gegensatz zu cancel_at_period_end werden diese Werte sofort in Zeitstempel aufgelöst und sind von weiteren Ä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, im Zusammenhang mit Abonnements mit gemischten Intervallen wird er jedoch standardmäßig zum frühesten Ende des Zeitraums gekündigt.

Ergebnis

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

  • Ein Abonnement erstellen
  • Abonnement aktualisieren
  • Rechnungsvorschau erstellen

Wenn Ihre Integration derzeit den abgeschafften Parameter cancel_at_period_end zum Kündigen von Abonnements verwendet, verwenden Sie stattdessen den neuen Parameter cancel_at mit dem Enum-Wert min_period_end. Das Feld cancel_at_period_end eines Abonnements ist nicht mit den neuen cancel_at-Helpern kompatibel.

Ä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.
Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
Schauen Sie sich unser Änderungsprotokoll an.
Fragen? Sales-Team kontaktieren.
LLM? Lesen Sie llms.txt.
Unterstützt von Markdoc