Abonnements kündigen

In diesem Leitfaden wird beschrieben, wie Sie die Subscription API oder das Dashboard zur Verwaltung von Kundenabonnements verwenden können.

Wenn das Abonnement aktiv bleiben soll, aber vorübergehend keine Zahlungen eingezogen werden sollen, können Sie den Zahlungseinzug unterbrechen. Dies hat keine Auswirkungen auf den Abonnementstatus. Wir empfehlen, diese Option für den Abschluss oder die Kündigung von Kundenabonnements zu verwenden.

Abonnements werden nach acht erfolglosen Abrechnungsversuchen automatisch gekündigt. Sie können die Anzahl der Versuche in Ihren Einstellungen für den Lebensyzklus eines Abonnements konfigurieren. Hier erhalten Sie weitere Informationen zu Einstellungen für die Umsatzsicherung, beispielsweise zu Smart Retries und konfigurierbaren Kunden-E-Mails.

Abonnements kündigen

Sie können Kundenabonnements manuell mit der API oder im Dashboard kündigen. Standardmäßig wird die Kündigung sofort wirksam und invoices werden für gekündigte Abonnements nicht mehr erstellt. Nach der Kündigung können Sie das Abonnement oder seine Metadaten nicht länger aktualisieren.

Anteilsmäßige Verrechnung für nutzungsbasierte Abrechnung

Wenn ein Abonnement bereits die Hälfte eines bezahlten Abrechnungszeitraums durchlaufen hat, können Sie die Kündigung anteilsmäßig verrechnen, indem Sie den prorate-Parameter übergeben.

Wenn Sie eine Stornierung anteilsmäßig verrechnen, können Sie optional Folgendes in Rechnung stellen:

• Ausstehende anteilsmäßige Verrechnungen
• Gemessene Nutzung

Wenn Sie das Abonnement nicht anteilsmäßig verrechnen, wird die gesamte gemessene Nutzung verworfen und der Kunde/die Kundin erhält keine Gutschrift für mögliche anteilismäßige Verrechnungen.

Erstellen Sie sofort eine endgültige Rechnung mit dem Parameter invoice_now. Wenn Sie dem Kunden/der Kundin nach der Kündigung eine Gutschrift schulden, können Sie die Gutschrift deren Guthaben für zukünftige Rechnungen hinzufügen. Um eine Rückerstattung an Ihren Kunden/Ihre Kundin auszustellen führen Sie Rückerstattungen durch und setzen Sie deren Kontosaldo wieder auf Null.

Am Ende des aktuellen Abrechnungszyklus stornieren

Um ein Abonnement am Ende des laufenden Abrechnungszeitraums zu kündigen, setzen Sie cancel_at_period_end auf true:

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d cancel_at_period_end=true

Auf diese Weise kann das Abonnement die Zeitspanne abdecken, für die der Kunde/die Kundin bereits bezahlt hat. Sie können Abonnements, deren Kündigung geplant ist, reaktivieren, indem Sie cancel_at_period_end auf false aktualisieren. Sie können das Abonnement bis zum Ende des Zeitraums jederzeit reaktivieren.

Stornierung nach geplanten Änderungen oder zukünftigen Abrechnungszyklen

Um ein Abonnement so zu planen, dass es nach einer bestimmten Anzahl von Abrechnungszyklen endet, erstellen Sie einen Abonnementplan. Legen Sie die Länge des Zeitplans fest, indem Sie eine oder mehrere Phasen und Intervalle angeben, und legen Sie das Attribut end_behavior auf cancel fest.

Mit einem Endverhalten von cancel verwalten Abonnementzeitpläne automatisch das Attribut cancel_at. Wenn sich der Zeitplan in der letzten Phase befindet, wird das Kündigungsdatum des Abonnements auf das Enddatum der Phase festgelegt. Andernfalls wird das Kündigungsdatum für das Abonnement nicht festgelegt.

Infolgedessen wird durch das Hinzufügen einer neuen Phase zu einem Zeitplan, der sich derzeit in der letzten Phase befindet, das Kündigungsdatum entfernt. Wenn sich das Abonnement beim Verlängern oder Entfernen des Kündigungsdatums in seinem letzten Abrechnungszeitraum befindet, kann dies den Anker für das Zeitraumende und den Abrechnungszyklus aktualisieren. Weitere Informationen zum Festlegen eines benutzerdefinierten Kündigungsdatums finden Sie hier.

Automatische Stornierung nach einer Zahlungsanfechtung konfigurieren

Wenn eine Kundin/ein Kunde eine Zahlung für ein Abonnement anficht, läuft das Abonnement zunächst weiter, wodurch weitere Zahlungsanfechtungen möglich sind. Sie können dieses Verhalten im Dashboard ändern, um Abonnements stattdessen zu kündigen. Änderungen an einem Abonnement werden nach ca. 1 Stunde wirksam.

Wählen Sie unter Angefochtene Zahlungen verwalten eine der folgenden Optionen aus:

• Abo mit sofortiger Wirkung kündigen ohne anteilsmäßige Verrechnung: Das Abonnement wird sofort und ohne anteilsmäßige Verrechnung gekündigt. Sie können ein gekündigtes Abonnement nicht wieder aufnehmen. Sie müssen ein neues Abonnement für den Kunden/die Kundin erstellen, wenn Sie ihm/ihr weiterhin Rechnungen stellen möchten.

• Abonnement zum Ende des Zeitraums kündigen: Das Abonnement wird zum Ende des aktuellen Abrechnungszeitraums gekündigt und cancel_at_period_end wird auf true gesetzt. Dadurch erhalten Sie Zeit für die Abwicklung angefochtener Zahlungen, bevor die Kündigung erfolgt.

Bei Abonnements mit Zeitplänen wird das Abonnement zunächst aus dem Plan freigegeben und dann gekündigt. Die übrigen geplanten Änderungen werden also nicht wirksam.

Rechnungsposten bei der Kündigung von Abonnements verarbeiten

In den folgenden Fällen werden Ihrem Kunden/Ihrer Kundin möglicherweise noch offene Rechnungsposten für ein Abonnement in Rechnung gestellt:

• Die Kündigung des Abonnements beinhaltet eine Schlussrechnung
• Ihr Kunde/Ihre Kundin hat ein anderes aktives Abonnement

Um zu verhindern, dass Ihr Kunde/Ihre Kundin ausstehende Rechnungsposten in Rechnung stellt, müssen Sie die Rechnungsposten manuell löschen.

Auf ähnliche Weise wird jede während des Abrechnungszeitraums gemeldete Nutzung am Ende des Zeitraums in Rechnung gestellt. Um eine Endabrechnung für die Nutzung auszuschließen, verwenden Sie den Parameter clear_usage, um das Abonnment zu aktualisieren und den nutzungsbasierten Preis zu entfernen.

Wenn Sie das Abonnement so konfigurieren, dass es am Ende des Zeitraums gekündigt wird, bleiben alle ausstehenden anteilmäßigen Verrechnungen bestehen und werden am Ende des Zeitraums eingezogen. Wenn Sie das Abonnement vor Ablauf des Zeitraums kündigen, bleiben die Rechnungsposten bestehen und werden nicht verarbeitet, sofern Sie nicht gezielt eine Rechnung erstellen, in denen sie enthalten sind.

Wenn Sie ein Abonnement kündigen, wird die Eigenschaft auto_advance für alle Rechnungen mit dem Status open und draft für dieses Abonnement auf false gesetzt. Dadurch wird die automatische Abrechnung für diese Rechnungen pausiert und der Versand von automatischen Erinnerungs-E-Mails verhindert. Sie können weiterhin manuell versuchen, die Zahlung einzuziehen und E-Mails zu versenden.

Kündigungsereignisse identifizieren

Stripe übermittelt die folgenden Ereignisse für gekündigte Abonnements.

Eine ausstehende Stornierung abbrechen

Sie können eine geplante Kündigung über die Update Subscription API oder das Dashboard stoppen. Sie können ein gekündigtes Abonnement nicht reaktivieren.

Ein individuelles Kündigungsdatum festlegen

Verwenden Sie den Parameter cancel_at, um ein Abonnement mit einem in der Zukunft liegenden Zeitstempel zu kündigen.

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d cancel_at=1723766400

Wenn Sie ein Kündigungsdatum planen, das vor dem Ende des Abrechnungszeitraums liegt, wird das current_period_end des Abonnements so aktualisiert, dass es mit dem cancel_at-Datum übereinstimmt. Dadurch werden anteilsmäßige Verrechnungen für die Änderung im aktuellen Zeitraum erstellt, es sei denn, durch Ihr Update werden anteilsmäßige Verrechnungen deaktiviert.

Wenn Sie ein Kündigungsdatum planen, das nicht in diesem oder im nächsten Zeitraum liegt, läuft der Abonnementzyklus so lange unverändert weiter, bis das Abonnement in den Zeitraum übergeht, in dem das Datum cancel_at liegt. Dann wird das current_period_end für die Verlängerung so verkürzt, dass es mit dem Datum cancel_at übereinstimmt.

Beispiel: Ihr Kunde/Ihre Kundin hat ein lizenziertes Abonnement für 120 USD pro Jahr abgeschlossen, das sich am 1. Januar 2024 verlängert. Er/Sie plant die Kündigung des Abonnements für den 1. Juli 2024. Die Zwischensumme der endgültigen Rechnung am 1. Januar beläuft sich auf 60 USD und das current_period_end ist am 1. Juli.

Wenn Sie ein geplantes Kündigungsdatum innerhalb des aktuellen Zeitraums ändern, hinzufügen oder entfernen, wird current_period_end aktualisiert und es werden anteilmäßige Verrechnungen erstellt. Im obigen Beispiel aktualisieren Sie am 15. Februar das Kündigungsdatum auf den 1. Oktober. Dadurch ändert sich das Ende des aktuellen Abrechnungszeitraums auf den 1. Oktober und Stripe erstellt anteilmäßige Verrechnungen in Höhe von 30 USD für das zusätzliche Quartal. Um die anteilsmäßig verrechneten Posten sofort und nicht in einer endgültigen Rechnung am 1. Oktober abzurechnen, können Sie das proration_behavior always_invoice in der Aktualisierung übergeben oder separat eine einmalige Rechnung erstellen.

Die Abonnementeigenschaft Abrechnungszyklusanker kann sich ändern, wenn das vorherige Kündigungsdatum verfolgt wurde. Während des ersten Zeitraums behält Stripe alle Anker bei, die Sie ursprünglich für das Abonnement haben. Wenn der erste Zeitraum abgelaufen ist oder Sie beim Erstellen des Abonnements keinen nutzerdefinierten Anker angegeben haben, wird der Anker auf den aktuellen Beginn des Zeitraums zurückgesetzt.

Das Hinzufügen eines Kündigungsdatums oder das Verschieben eines vorhandenen Datums näher an den aktuelle Zeitpunkt verkürzt den Abrechnungszyklusanker, um dem neuen Kündigungsdatum zu entsprechen. Im obigen Beispiel aktualisieren Sie am 15. Februar das Kündigungsdatum auf den 1. April. Das Ende des Zeitraums und der Abrechnungsanker werden zum 1. April, und Stripe erstellt anteilmäßige Verrechnungen von -30 USD, um Ihrem Kunden/Ihrer Kundin die ungenutzte Zeit vom 1. April bis zum 1. Juli gutzuschreiben.