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

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 Abo-Postens ä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.

Hinweis

Bei Abos mit gemischten Intervallen wird die bestehende Funktion cancel_at_period_end immer auf den frühesten Posten aufgelöst.

Ergebnis

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

Wenn Ihre Integration im flexiblen Billing-Modus derzeit cancel_at_period_end verwendet, um Abos zu kündigen, aktualisieren Sie Ihre Integration wie folgt:

  • 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 Elemente in einem Abo aktualisieren, können Sie in derselben Anfrage cancel_at: min_period_end oder cancel_at: max_period_end hinzufügen, um den vorhandenen Zeitstempel cancel_at des Abos zurückzusetzen.

Hinweis

Diese Änderung wird im .NET SDK erst in Version 49.0.0 verfügbar sein und das Java SDK erst in Version 30.0.0. Bis diese Versionen verfügbar sind, befolgen Sie die Anweisungen zum Senden nicht dokumentierte Parameter , um die neuen Enumerationswerte an die cancel_at-Parameter weiterzugeben.

Ä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')

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