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.

Ergebnis

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

• Ein Abonnement erstellen
• Ein Abonnement aktualisieren
• Eine Rechnungsvorschau erstellen

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

Upgrade