Abonnements kündigen
Erfahren Sie, wie Sie bestehende Abonnements kündigen können.
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.
Häufiger Fehler
Wenn Sie ein nutzerdefiniertes Kündigungsdatum festlegen, können Sie keine Rückerstattung leisten. Es wird immer eine anteilige Gutschrift generiert. Um zu verhindern, dass eine anteilige Gutschrift generiert wird, stellen Sie sicher, dass das nutzerspezifische Kündigungsdatum innerhalb des aktuellen Abrechnungszeitraums liegt und proration_ auf none festgelegt ist.
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_ auf 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_ 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
Eingeschränkte Unterstützung
Diese Funktion wird nur für angefochtene Kredit- und Debitkartenzahlungen unterstützt, die zum vollständigen Betrag eröffnet wurden. Die Verzögerung für eine automatische Kündigung ist nicht mit Test-Uhren kompatibel.
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
truegesetzt. 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_ 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.
| Ereignis | Beschreibung |
|---|---|
customer. | Wird bei jeder Abonnementaktualisierung gesendet, auch wenn cancel_ auf true gesetzt ist. |
customer. | Wird gesendet, wenn ein Abonnement gekündigt wird. Die Kündigung kann durch einen direkten Aufruf zum Löschen des Abonnements erfolgen oder wenn ein Abonnement mit dem Parameter cancel_ das Ende seines Abrechnungszeitraums erreicht. |
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.
Wenn Sie ein Kündigungsdatum planen, das vor dem Ende des Abrechnungszeitraums liegt, wird das current_period_end des Abonnementpostens so aktualisiert, dass es mit dem cancel_-Datum übereinstimmt. Dadurch werden anteilige Verrechnungen für die Änderung im aktuellen Zeitraum erstellt, es sei denn, durch Ihre Aktualisierung wird die anteilsmäßige Verrechnung deaktiviert.
Wenn Sie ein Kündigungsdatum planen, das mehr als einen Zeitraum in der Zukunft liegt, bleibt der Zyklus des Abonnements davon unberührt, bis das Abonnement in den Zeitraum übergeht, in dem das Datum cancel_ liegt. Das items. für die Verlängerung wird dann so verkürzt, dass es mit dem cancel_-Datum übereinstimmt.
Beispiel: Ihr Kunde/Ihre Kundin abonniert ein lizenziertes Abonnement im Wert von 120 USD pro Jahr, das am 1. Januar 2024 verlängert wird. Das Abonnement wird am 1. Juli 2024 gekündigt. Die Zwischensumme der endgültigen Rechnung am 1. Januar beträgt 60 USD und das items. ist der 1. Juli.
Durch Ändern, Hinzufügen oder Entfernen eines geplanten Kündigungsdatums innerhalb des aktuellen Zeitraums wird das items. aktualisiert und es werden anteilmäßige Verrechnungen erstellt. Im obigen Beispiel aktualisieren Sie am 15. Februar das Kündigungsdatum auf den 1. Oktober. Das Ende des aktuellen Zeitraums ist der 1. Oktober, und Stripe erstellt anteilmäßige Verrechnungen in Höhe von 30 USD für das zusätzliche Quartal. Um die anteilmäßig verrechneten Posten sofort anstatt auf einer Schlussrechnung am 1. Oktober in Rechnung zu stellen, übergeben Sie in der Aktualisierung always_ für proration_behavior oder erstellen Sie eine einmalige Rechnung separat.
Die Eigenschaft Abrechnungszyklusanker des Abonnements kann sich ändern, wenn das vorherige Kündigungsdatum nachverfolgt wurde. Während des ersten Zeitraums behält Stripe jeden Anker bei, den Sie ursprünglich für das Abonnement festgelegt haben. Wenn der erste Zeitraum endet oder wenn Sie beim Erstellen des Abonnements keinen nutzerdefinierten Anker angegeben haben, wird der Anker auf den Beginn des aktuellen Zeitraums zurückgesetzt. Dieses Zurücksetzungsverhalten für den Abrechnungszyklusanker ist nur für Abonnements garantiert, die nach Juni 2024 erstellt wurden. Vor diesem Datum erstellte Abonnements weisen möglicherweise das Legacy-Verhalten auf, bei dem die Eigenschaft Abrechnungszyklusanker nach einer Kündigung, Entfernung oder Verlängerung unverändert bleibt.
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.