Fügt Hilfsfunktionen zum Abbrechen von Abonnements für Rechnungsstellungszeiträume mit gemischten Intervallen hinzu.

Das ändert sich

Wir haben die folgenden cancel_at Enum-Werte eingeführt, um die Kündigung eines gemischten Intervall- Abonnements am Ende eines Rechnungsstellungszeitraums zu vereinfachen:

min_period_end: Legt die Kündigung des Abonnements zum frühesten Zeitpunkt items.data.current_period_end für alle Posten des Abonnements an.
max_period_end: Plant die Beendigung des Abonnements zum spätesten items.data.current_period_end für alle Posten des Abonnements.

In Anfragen, die sowohl den Wert current_period_end eines Postens des Abonnements ändern als auch einen dieser neuen Werte festlegt, wird der aktualisierte Wert current_period_end als das entsprechende Kündigungsdatum verwendet. Im Gegensatz zu cancel_at_period_end werden diese Werte sofort in Zeitstempel aufgelöst und weitere Änderungen an items.data.current_period_end wirken sich nicht auf sie aus.

Notiz

Bei Abonnements mit gemischten Intervallen bezeiht sich die bestehende Funktion cancel_at_period_end immer auf das früheste Laufzeitende eines Postens.

Ergebnis

Die folgenden API-Endpoints unterstützen die neuen Enums:

Wenn Ihre flexible Abrechnungsmodus-Integration derzeit cancel_at_period_end zum Stornieren von Abonnements verwendet, aktualisieren Sie Ihre Integration auf eine der folgenden Optionen:

Verwenden Sie die neuen Enum-Werte min_period_end oder max_period_end, um anzugeben, welches Intervall eine Stornierung auslöst.
Füllen Sie cancel_at mit einem expliziten ganzzahligen Zeitstempel aus.

Der Parameter cancel_at_period_end in einem Abonnement ist nicht mit den neuen cancel_at-Hilfsfunktionen kompatibel.

Wenn Sie den Wert current_period_end für Posten in einem Abonnement aktualisieren, können Sie in derselben Anfrage cancel_at: min_period_end oder cancel_at: max_period_end hinzufügen, um den bestehenden Zeitstempel cancel_at des Abonnements zurückzusetzen.

Änderungen

Felder	Ändern	Von → bis
Invoice#create_preview.subscription_details.cancel_atSubscription#create.cancel_atSubscription#update.cancel_at	Geändert	`DateTime → DateTime \| enum('max_period_end'\|'min_period_end')`

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-07-30.basil
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.