# Abonnements kündigen Erfahren Sie, wie Sie bestehende Abonnements kündigen können. Kundinnen und Kunden können ihre Abonnements, Rechnungen und Abrechnungsinformationen auch über die von Stripe gehostete [Kündigungsseite des Kundenportals](https://docs.stripe.com/customer-management/cancellation-page.md) verwalten. In diesem Leitfaden wird beschrieben, wie Sie die [Subscription API](https://docs.stripe.com/api.md#cancel_subscription) oder das [Dashboard](https://dashboard.stripe.com/test/subscriptions) 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](https://docs.stripe.com/billing/subscriptions/pause-payment.md). Dies hat keine Auswirkungen auf den [Abonnementstatus](https://docs.stripe.com/billing/subscriptions/overview.md#subscription-statuses). Wir empfehlen, diese Option für den Abschluss oder die Kündigung von Kundenabonnements zu verwenden. *Abonnements* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis) werden automatisch gekündigt, nachdem bis zu acht erfolglose Versuche unternommen wurden, der Kundin oder dem Kunden eine Rechnung zu stellen. Sie können die Anzahl der Versuche in den [Abonnementeinstellungen](https://dashboard.stripe.com/settings/billing/automatic) Ihres Dashboards konfigurieren. Erfahren Sie mehr über Einstellungen zur Umsatzsicherung, wie [Smart Retries](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md#smart-retries) und konfigurierbare [Kunden-E-Mails](https://docs.stripe.com/billing/revenue-recovery/customer-emails.md#configure-emails). ## Abonnements kündigen Sie können Kundenabonnements manuell mit der [API](https://docs.stripe.com/api/subscriptions/cancel.md) oder im [Dashboard](https://dashboard.stripe.com/test/subscriptions) kündigen. Standardmäßig wird die Kündigung sofort wirksam und *invoices* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) werden für gekündigte Abonnements nicht mehr erstellt. Nach der Kündigung können Sie das Abonnement oder seine [Metadaten](https://docs.stripe.com/metadata.md) nicht länger aktualisieren. > 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_behavior` auf `none` festgelegt ist. #### Dashboard So kündigen Sie ein Abonnement im Dashboard: 1. Klicken Sie auf der Seite [Abonnements](https://dashboard.stripe.com/test/subscriptions) auf das Überlaufmenü (⋯) und wählen Sie dann **Abonnement kündigen** aus. 1. Wählen Sie, wann das Abonnement enden soll: sofort, am Ende des Zeitraums oder an einem nutzerdefinierten Tag. 1. Wählen Sie aus, ob Sie einen [anteiligen](https://docs.stripe.com/billing/subscriptions/prorations.md) Betrag erstatten, die letzten Zahlung in voller Höhe zurückerstatten oder keine [Rückerstattung](https://docs.stripe.com/refunds.md) vornehmen möchten. 1. Nachdem Sie alle Einstellungen finalisiert haben, klicken Sie auf **Abonnement kündigen**. #### API So kündigen Sie ein Abonnement über die API: ```curl curl -X DELETE https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" ``` ### 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](https://docs.stripe.com/api/subscriptions/cancel.md#cancel_subscription-prorate)-Parameter übergeben. Wenn Sie eine Stornierung anteilsmäßig verrechnen, können Sie optional Folgendes in Rechnung stellen: - Ausstehende anteilsmäßige Verrechnungen - [Gemessene Nutzung](https://docs.stripe.com/products-prices/pricing-models.md#usage-based-pricing) 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](https://docs.stripe.com/api/subscriptions/cancel.md#cancel_subscription-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](https://support.stripe.com/questions/refunding-credit-balance-to-customer-after-subscription-downgrade-or-cancellation) führen Sie [Rückerstattungen](https://docs.stripe.com/refunds.md#issuing) durch und setzen Sie deren [Kontosaldo](https://docs.stripe.com/billing/customer/balance.md#modifying) wieder auf Null. ### Kündigung zum Ende des aktuellen Rechnungsstellungszeitraums Um ein Abonnement am Ende des laufenden Abrechnungszeitraums zu kündigen, setzen Sie `cancel_at_period_end` auf `true`: ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -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. ### Kündigung nach geplanten Änderungen oder zukünftigen Rechnungsstellungszeiträumen Um ein Abo so zu planen, dass es nach einer bestimmten Anzahl von Rechnungsstellungszeiträumen endet, [erstellen Sie einen Abonnementplan](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md). Legen Sie die Länge des Zeitplans fest, indem Sie eine oder mehrere Zeiträume und Intervalle angeben und setzen Sie das Attribut [end_behavior](https://docs.stripe.com/api/subscription_schedules/create.md#create_subscription_schedule-end_behavior) auf `cancel`. Mit einem Endverhalten von `cancel` verwalten Abonnementzeitpläne automatisch das Attribut [cancel_at](https://docs.stripe.com/billing/subscriptions/cancel.md#custom-cancel-date). 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](https://docs.stripe.com/billing/subscriptions/cancel.md#custom-cancel-date) 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](https://docs.stripe.com/billing/testing/test-clocks/simulate-subscriptions.md) kompatibel. Wenn eine Kundin/ein Kunde eine Zahlung für ein Abonnement [anficht](https://docs.stripe.com/disputes.md), läuft das Abonnement zunächst weiter, wodurch weitere Zahlungsanfechtungen möglich sind. Sie können dieses Verhalten im [Dashboard](https://dashboard.stripe.com/settings/billing/automatic) ändern, um Abonnements stattdessen zu kündigen. Änderungen an einem Abonnement werden nach ca. 1 Stunde wirksam. Wählen Sie unter [Angefochtene Zahlungen verwalten](https://dashboard.stripe.com/settings/billing/automatic) 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](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-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](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md) 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](https://docs.stripe.com/billing/invoices/subscription.md#adding-draft-invoice-items) 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](https://docs.stripe.com/api.md#delete_invoiceitem). Auf ähnliche Weise wird jede während des Abrechnungszeitraums gemeldete [Nutzung](https://docs.stripe.com/billing/subscriptions/usage-based/recording-usage.md) am Ende des Zeitraums in Rechnung gestellt. Um eine Endabrechnung für die Nutzung auszuschließen, verwenden Sie den Parameter [clear_usage](https://docs.stripe.com/api.md#update_subscription-items-clear_usage), um das [Abonnment zu aktualisieren](https://docs.stripe.com/api.md#update_subscription) 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](https://docs.stripe.com/invoicing/integration/automatic-advancement-collection.md) 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.subscription.updated` | Wird bei jeder Abonnementaktualisierung gesendet, auch wenn `cancel_at_period_end` auf `true` gesetzt ist. | | `customer.subscription.deleted` | 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_at_period_end: true` das Ende seines Abrechnungszeitraums erreicht. | ## Eine ausstehende Stornierung abbrechen Sie können eine geplante Kündigung über die [Update Subscription API](https://docs.stripe.com/api/subscriptions/update.md) oder das [Dashboard](https://dashboard.stripe.com/test/subscriptions) stoppen. Sie können ein gekündigtes Abonnement nicht reaktivieren. #### Dashboard So stoppen Sie eine geplante Kündigung im Dashboard: 1. Wählen Sie auf der Seite [Abonnements](https://dashboard.stripe.com/test/subscriptions) das Abonnement aus, das Sie aktualisieren möchten. 1. Navigieren Sie auf der Seite mit den Abonnementdetails zu **Aktionen** und wählen Sie **Nicht kündigen** aus. #### API Um eine geplante Stornierung mit der API zu stoppen, setzen Sie `cancel_at_period_end` auf `false`. Diese Aktion betrifft nur Abonnements, bei denen das Ende des Abrechnungszeitraums noch nicht erreicht ist. ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -d cancel_at_period_end=false ``` > Bis zur Version vom [28.02.2018](https://docs.stripe.com/upgrades.md#2018-02-28) hat *jeder* an die [Update Subscription API](https://docs.stripe.com/api/subscriptions/update.md) übermittelte Parameter eine anstehende Kündigung gestoppt. ## Ein individuelles Kündigungsdatum festlegen Verwenden Sie den Parameter [cancel_at](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-cancel_at), um ein Abonnement mit einem in der Zukunft liegenden Zeitstempel zu kündigen. ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -d cancel_at=1723766400 ``` Wenn Sie ein Kündigungsdatum planen, das vor dem Ende des Abrechnungszeitraums liegt, wird das [current_period_end](https://docs.stripe.com/api/subscription_item/object.md#subscription_item_object-current_period_end) des Abonnementpostens so aktualisiert, dass es mit dem `cancel_at`-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](https://docs.stripe.com/billing/subscriptions/prorations.md#disable-prorations). Bei Abonnements vom Typ `billing_mode=flexible` mit `status=trialing` wirkt sich das Hinzufügen, Aktualisieren oder Entfernen des Werts `cancel_at` nicht auf das [trial_end](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-trial_end)-Datum aus. Für Abonnements, die [billing_mode](https://docs.stripe.com/api/subscriptions/create.md?api-version=2025-04-30.preview#create_subscription-billing_mode) verwenden, können Sie Enum-Helper mit dem Parameter `cancel_at` verwenden, um die Kündigung eines Abonnements am Ende eines Abrechnungszeitraums zu vereinfachen. Mit den Helpern `min_period_end` und `max_period_end` können Sie angeben, wann ein Abonnement basierend auf den Abrechnungszeiträumen für alle Abonnementposten gekündigt werden soll. | Ereignis | Beschreibung | | ---------------- | ------------------------------------------------------------------------------ | | `min_period_end` | Wählt den Zeitstempel für den Abrechnungszeitraum aus, der am frühesten endet. | | `max_period_end` | Wählt den Zeitstempel für den Abrechnungszeitraum aus, der zuletzt endet. | Diese Hilfsprogramme lösen Zeitstempel sofort auf, wodurch das Risiko verringert wird, dass sich spätere Änderungen am `current_period_end` eines Postens auf den aufgelösten Stornierungszeitstempel auswirken. 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_at` liegt. Das `items.current_period_end` für die Verlängerung wird dann so verkürzt, dass es mit dem `cancel_at`-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.current_period_end` ist der 1. Juli. Durch Ändern, Hinzufügen oder Entfernen eines geplanten Kündigungsdatums innerhalb des aktuellen Zeitraums wird das `items.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. 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_invoice` für [proration_behavior](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-proration_behavior) oder [erstellen Sie eine einmalige Rechnung](https://docs.stripe.com/billing/invoices/subscription.md#generating-invoices) separat. ## Stornierung mit Abrechnungszyklusanker Die Eigenschaft [Abrechnungszyklusanker](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-billing_cycle_anchor) 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](https://docs.stripe.com/billing/subscriptions/billing-cycle.md#new-subscriptions) 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](https://docs.stripe.com/api/subscription_items/object.md#subscription_item_object-current_period_start) 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](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-billing_cycle_anchor) 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](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-billing_cycle_anchor), 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. ## See also - [Testzeiträume verwenden](https://docs.stripe.com/billing/subscriptions/trials.md) - [Abonnement aktualisieren](https://docs.stripe.com/api.md#update_subscription) - [Abonnement kündigen](https://docs.stripe.com/api.md#cancel_subscription)