# So funktionieren Abonnements Verwalten Sie wiederkehrende Zahlungen und Abonnementlebenszyklen. Mit Abonnements können Kundinnen und Kunden wiederkehrende Zahlungen leisten, um Zugang zu einem Produkt oder einer Dienstleistung zu erhalten. Wenn Sie ein Abonnement anlegen, generiert Stripe automatisch Rechnungen, versucht, die Zahlung einzuziehen, und verwaltet den Abonnementstatus während des gesamten Lebenszyklus. Ein Abonnement durchläuft eine vorhersehbare Abfolge von Statusphasen, von der Erstellung bis zur Kündigung. Im Gegensatz zu einmaligen Zahlungen erfordern Abonnements die Speicherung von Informationen zu Kundinnen und Kunden und Zahlungsmethoden für zukünftige Abrechnungszyklen. Stripe übernimmt die Logik für Zahlungswiederholungsversuche, das Mahnwesen und Statusübergänge. ## Lifecycle eines Abonnements Jede der folgenden Phasen im Lifecycle eines Abonnements entspricht einer Statusänderung am [Objekt „Abonnement“](https://docs.stripe.com/api/subscriptions/object.md). Das Verständnis dieser Status hilft Ihnen dabei, zu wissen, wann Sie den Zugriff bereitstellen, Kundinnen und Kunden benachrichtigen und Fehler behandeln müssen. Sie können [Webhook-Ereignisse](https://docs.stripe.com/billing/subscriptions/webhooks.md#state-changes) nutzen, um Übergänge zwischen den Status zu überwachen und zu verarbeiten. ### Abonnement erstellen Erstellen Sie ein neues Abonnement im [Dashboard](https://dashboard.stripe.com/subscriptions?status=active) oder über die [Subscriptions API](https://docs.stripe.com/api/subscriptions/create.md). Das resultierende [Objekt „Abonnement“](https://docs.stripe.com/api/subscriptions/object.md) enthält den abonnierten Kunden oder die abonnierte Kundin, das [Produkt](https://docs.stripe.com/api/products.md) und den [Preis](https://docs.stripe.com/api/prices/object.md) sowie den `Status`, der den aktuellen Status des Abonnements im Lifecycle widerspiegelt. Wenn Sie ein Abonnement erstellen, das eine sofortige Zahlung erfordert, erstellt Stripe zusätzlich eine [Rechnung](https://docs.stripe.com/billing/invoices/subscription.md) und ein [PaymentIntent](https://docs.stripe.com/payments/payment-intents.md). Der anfängliche Status des Abonnements lautet `unvollständig` und wechselt zu `aktiv`, sobald der Kunde oder die Kundin die erste Rechnung bezahlt hat. > Zahlungsmethoden mit *verzögerter* (A payment method that can't immediately return payment status when a customer attempts a transaction (for example, ACH debits). Businesses commonly hold an order in a pending state until payment is successful with these payment methods) Zahlungsbestätigung, wie z. B. ACH Direct Debit, können einen anderen Status aufweisen. Weitere Informationen finden Sie unter [Verzögerte Zahlungsbestätigung](https://docs.stripe.com/billing/subscriptions/overview.md#delayed-payment-confirmation). Das standardmäßige Einzugsverfahren für Abonnements und die Fehlerbehandlung hängen von der Zahlungsmethode ab. In der API können Sie das [payment_behavior](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-payment_behavior) eines Abonnements konfigurieren, um die Standardeinstellung zu überschreiben. Wenn Sie einen [Testzeitraum](https://docs.stripe.com/billing/subscriptions/trials.md) einrichten, um die erste Abbuchung für das Abonnement zu verzögern, lautet der anfängliche Status `Testen`, und das Abonnement wechselt automatisch in den Status `aktiv`, sobald der Testzeitraum endet und die Zahlung erfolgreich war. ### Die Rechnung bearbeiten Bei Abonnements, bei denen `collection_method` auf `charge_automatically` gesetzt ist, erstellt Stripe beim Anlegen des Abonnements eine [Rechnung](https://docs.stripe.com/billing/invoices/subscription.md) mit dem Status `offen`. Ihr Kunde oder Ihre Kundin hat 23 Stunden Zeit, um zu bezahlen. Während dieser Zeit lautet der Abonnementstatus `unvollständig` und der Rechnungsstatus bleibt z`offen`. Dieses 23-Stunden-Fenster berücksichtigt Kundinnen und Kunden, die während der *Sitzung* (A payment is described as on-session if it occurs while the customer is actively in your checkout flow and able to authenticate the payment method) bezahlen. Wenn der Kunde oder die Kundin nach 23 Stunden zu Ihrer Anwendung zurückkehrt, erstellen Sie ein neues Abonnement für ihn bzw. sie. Für Abonnements, bei denen die `collection_method` auf `send_invoice` festgelegt ist, sendet Stripe der Kundin/dem Kunden per E-Mail einen Link zur Rechnung mit einem konfigurierbaren Fälligkeitsdatum. Für Abonnements ohne Testphase ist der anfängliche Status des Abonnements `aktiv`, auch wenn die erste Rechnung unbezahlt ist. Weitere Informationen finden Sie unter [Rechnungen für Abonnements](https://docs.stripe.com/billing/invoices/subscription.md). ### Zahlung bestätigen Für Abonnements, bei denen die `collection_method` auf `charge_automatically` festgelegt ist, wird das Abonnement auf `aktiv` und die Rechnung auf `gezahlt` aktualisiert, wenn Ihre Kundin/Ihr Kunde die Rechnung bezahlt. Achten Sie auf das Ereignis [invoice.paid](https://docs.stripe.com/billing/subscriptions/webhooks.md#events) oder bestätigen Sie, dass der Status des Abonnements `aktiv` ist. Stripe legt [current_period_start](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-items-data-current_period_start) des Abonnements fest, wenn die erste Rechnung erstellt wird. Ein späterer Zahlungsabschluss verschiebt den Beginn des ersten Rechnungsstellungszeitraums nicht. Wenn eine Zahlungsmethode eine Aktion der Kundin/des Kunden erfordert und die Kundin/der Kunde den Abschluss verzögert, verbleibt im ersten Rechnungsstellungszeitraum weniger Zeit, wenn Sie den Zugriff bereitstellen. Für diese Abonnements gilt: Wenn die Kundin/der Kunde nicht innerhalb von 23 Stunden bezahlt, wird das Abonnement auf `incomplete_expired` aktualisiert und die Rechnung wird zu `ungültig`. Um den Zugang wieder zu aktivieren, erstellen Sie ein neues Abonnement. Weitere Informationen finden Sie unter [Abonnementstatus](https://docs.stripe.com/billing/subscriptions/overview.md#subscription-statuses) und [Zahlungsstatus](https://docs.stripe.com/billing/subscriptions/overview.md#payment-status). ### Zugang zu Ihrem Produkt bereitstellen Wenn ein Abonnement den Status `aktiv` erhält, erstellt Stripe für jede mit dem abonnierten Produkt verbundene Funktion eine aktive [Berechtigung](https://docs.stripe.com/billing/entitlements.md). Wenn ein Kunde auf Ihre Dienste zugreift, nutzen Sie seine aktiven Berechtigungen, um ihm Zugriff auf die in seinem Abonnement enthaltenen Funktionen zu gewähren. [Verfolgen Sie aktive Abonnements](https://docs.stripe.com/billing/subscriptions/webhooks.md#active-subscriptions) alternativ mit Webhook-Ereignissen und stellen Sie das Produkt der Kundin oder dem Kunden auf der Grundlage dieser Aktivität bereit. ### Abonnement aktualisieren Sie können [bestehende Abonnements](https://docs.stripe.com/billing/subscriptions/change.md) nach Bedarf ändern, ohne sie kündigen und neu erstellen zu müssen. Zu den wichtigsten Änderungen, die Sie vornehmen können, gehören die [Erhöhung oder Senkung](https://docs.stripe.com/billing/subscriptions/change-price.md) des Abonnementpreises oder [die Aussetzung der Zahlungsabwicklung](https://docs.stripe.com/billing/subscriptions/pause-payment.md) für ein aktives Abonnement. Bei [Stripe Checkout](https://docs.stripe.com/payments/checkout.md)-Integrationen können Sie das Abonnement oder die dazugehörige Rechnung nicht aktualisieren, wenn das Abonnement der Sitzung `incomplete` ist. Sie können das Ereignis [checkout.session.completed](https://docs.stripe.com/api/events/types.md#event_types-checkout.session.completed) überwachen, um die Aktualisierung nach Abschluss der Sitzung durchzuführen. Sie können [die Sitzung auch stattdessen ablaufen lassen](https://docs.stripe.com/api/checkout/sessions/expire.md), wenn Sie das Abonnement der Sitzung stornieren, die Abonnementrechnung für ungültig erklären oder die Rechnung als uneinbringlich kennzeichnen möchten. ### Unbezahlte Abonnements bearbeiten Wenn der Kunde oder die Kundin eine Abonnementrechnung nicht bezahlt, unterbricht Stripe weitere Einzugsversuche. Das Abonnement generiert weiterhin in jedem Abrechnungszeitraum Rechnungen, die im Status `Entwurf` verbleiben. Der Status des Abonnements (`past_due` oder `unbezahlt`) hängt von Ihren [Einstellungen für fehlgeschlagene Zahlungen](https://dashboard.stripe.com/settings/billing/automatic#manage-failed-payments) im Dashboard ab. Stornierte Rechnungen haben keinen Einfluss auf den Abonnementstatus. Abhängig von Ihren [Abonnementeinstellungen](https://dashboard.stripe.com/settings/billing/subscriptions#manage-failed-payments) bestimmt Stripe den Status anhand der letzten nicht stornierten Rechnung oder aller zutreffenden ausstehenden Rechnungen. Weitere Informationen finden Sie unter [Auflösung des Abonnementstatus konfigurieren](https://docs.stripe.com/billing/subscriptions/overview.md#subscription-status-resolution) und [Fehlgeschlagene Abonnementzahlungen](https://docs.stripe.com/billing/collection-method.md#failed-subscription-payments). ### Das Abonnement kündigen Sie können ein Abo jederzeit [kündigen](https://docs.stripe.com/billing/subscriptions/cancel.md), auch am [Ende eines Abrechnungszeitraums](https://docs.stripe.com/billing/subscriptions/cancel.md#cancel-at-the-end-of-the-current-billing-period) oder nach einer [festgelegten Anzahl von Abrechnungszeiträumen](https://docs.stripe.com/billing/subscriptions/cancel.md#subscription-schedules). Standardmäßig wird durch das Kündigen eines Abonnements die Erstellung neuer Rechnungen deaktiviert und [die automatische Einziehung](https://docs.stripe.com/billing/subscriptions/cancel.md#handle-invoice-items-when-canceling-subscriptions) aller ausstehenden Rechnungen aus dem Abonnement gestoppt. Außerdem wird das Abonnement gelöscht, sodass Sie das Abonnement mit Ausnahme seiner [metadata](https://docs.stripe.com/metadata.md) und `cancellation_details` nicht mehr aktualisieren können. Wenn Ihre Kundin oder Ihr Kunde das Abonnement erneut abschließen möchte, müssen Sie neue Zahlungsinformationen einholen und ein neues Abonnement erstellen. ## Abonnement-Statusangaben Subscriptions kann den folgenden Status haben. Die Aktionen, die Sie für ein Abonnement durchführen können, hängen von dessen Status ab. | Status | Beschreibung | | --- | --- | | `trialing` | Das Abonnement befindet sich derzeit in einem Testzeitraum und Sie können Ihr Produkt sicher für Ihre Kundinnen/Kunden bereitstellen. Das Abonnement wechselt automatisch in den Status `active`, wenn ein Kunde/eine Kundin die erste Zahlung tätigt. | | `active` | Das Abonnement befindet sich in einem ordnungsgemäßen Zustand. Ihre [Abonnementeinstellungen](https://dashboard.stripe.com/settings/billing/subscriptions#manage-failed-payments) bestimmen, welche Rechnungen beglichen werden müssen, um ein `past_due`-Abonnement auf `aktiv` umzustellen. Wenn für die Statusermittlung die neueste Rechnung herangezogen wird, verwendet Stripe die neueste nicht stornierte Rechnung, um den Status des Abonnements zu bestimmen. Wenn Sie diese Rechnung bezahlen oder manuell als uneinbringlich markieren, wird das Abonnement auf `aktiv` umgestellt. Wenn für die Statusermittlung alle Rechnungen herangezogen werden, begleichen Sie alle zutreffenden offenen Rechnungen, um das Abonnement auf `aktiv` umzustellen. `active` bedeutet nicht zwangsläufig, dass alle mit dem Abonnement verknüpften offenen Rechnungen bezahlt wurden. Wenn die Statusauflösung die aktuellste Rechnung verwendet, können Sie andere ausstehende Rechnungen nach eigenem Ermessen zur Zahlung offen lassen, als uneinbringlich markieren oder stornieren. | | `incomplete` | Die Kundin/der Kunde muss innerhalb von 23 Stunden eine erfolgreiche Zahlung leisten, um das Abonnement zu aktivieren. Oder die Zahlung [erfordert eine Aktion](https://docs.stripe.com/billing/subscriptions/overview.md#requires-action), wie beispielsweise eine Kundenauthentifizierung. Abonnements können auch `incomplete` sein, wenn eine ausstehende Zahlung vorliegt und der Status des PaymentIntents `processing` lautet. | | `incomplete_expired` | Die erste Zahlung für das Abonnement ist fehlgeschlagen und der Kunde/die Kundin hat innerhalb von 23 Stunden nach Erstellung des Abonnements keine erfolgreiche Zahlung getätigt. Diese Abonnements werden Kundinnen/Kunden nicht in Rechnung gestellt. Dieser Status dient dazu, Kundinnen/Kunden nachzuverfolgen, die ihre Abonnements nicht aktivieren konnten. | | `past_due` | Die Zahlung für die letzte abgeschlossene Rechnung ist entweder fehlgeschlagen oder wurde nicht versucht. Wenn die Statusermittlung alle Rechnungen verwendet, kann `past_due` auch darauf hinweisen, dass eine frühere entsprechende Rechnung weiterhin offen ist. Das Abonnement erstellt weiterhin Rechnungen. Stripe versucht die Zahlung möglicherweise erneut, während das Abonnement auf `past_due` steht, dieser Status garantiert jedoch keinen weiteren Zahlungsversuch. Ihre [Abonnement-Einstellungen](https://dashboard.stripe.com/settings/billing/subscriptions#manage-failed-payments) im Dashboard bestimmen den nächsten Status des Abonnements. Wenn eine Rechnung nach allen versuchten [Zahlungswiederholungen](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md) weiterhin unbezahlt ist, können Sie das Abonnement so konfigurieren, dass es in den Status `storniert` oder `unbezahlt` wechselt oder auf `past_due` bleibt. Um das Abonnement zu reaktivieren, bezahlen Sie die neueste nicht stornierte Rechnung oder markieren Sie diese manuell als uneinbringlich, wenn für die Statusermittlung die neueste Rechnung herangezogen wird, oder begleichen Sie zutreffende offene Rechnungen, wenn für die Statusermittlung alle Rechnungen herangezogen werden. Das Abonnement wird `aktiv`, unabhängig davon, ob Sie die erforderlichen Rechnungen vor oder nach deren Fälligkeitsdatum begleichen. | | `canceled` | Das Abonnement wurde gekündigt. Während der Kündigung ist der automatische Einzug für alle unbezahlten Rechnungen deaktiviert (`auto_advance=false`). Dies ist ein endgültiger Status, der nicht aktualisiert werden kann. | | `unpaid` | Stripe setzt den Status eines Abonnements nur dann auf `nicht bezahlt`, wenn Ihre [Abonnementeinstellungen](https://dashboard.stripe.com/settings/billing/subscriptions#manage-failed-payments) im Dashboard dies vorsehen. Die Rechnung oder die Rechnungen, die für den Status des Abonnements maßgeblich sind, wurden nicht beglichen, aber das Abonnement bleibt bestehen. Das Abonnement generiert weiterhin Rechnungen, unternimmt jedoch keine Zahlungsversuche. Entziehen Sie den Zugriff auf Ihr Produkt, wenn das Abonnement `nicht bezahlt` ist, da Stripe bereits Zahlungsversuche unternommen und wiederholt hat, während das Abonnement `past_due` war. Um das Abonnement auf `aktiv` umzustellen, bezahlen Sie die neueste nicht stornierte Rechnung oder markieren Sie diese manuell als uneinbringlich, wenn für die Statusermittlung die neueste Rechnung herangezogen wird, oder begleichen Sie zutreffende offene Rechnungen, wenn für die Statusermittlung alle Rechnungen herangezogen werden. | | `paused` | Das Abonnement hat seinen Testzeitraum ohne hinterlegte Zahlungsmethode beendet und die [trial_settings.end_behavior.missing_payment_method](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md#create-free-trials-without-payment) wird auf `pause` gesetzt. Für das Abonnement werden keine Rechnungen mehr erstellt. Nachdem Sie dem Kunden/der Kundin eine Standardzahlungsmethode hinzugefügt haben, können Sie [das Abonnement fortsetzen](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md#resume-a-paused-subscription). | ### Auflösung des Abonnementstatus konfigurieren Wählen Sie in Ihren [Abonnementeinstellungen](https://dashboard.stripe.com/settings/billing/subscriptions#manage-failed-payments) aus, welche Rechnungen Stripe verwenden soll, um den Abonnementstatus zu ermitteln: - **Neueste Rechnung**: Dies ist das Standardverhalten. Stripe verwendet die letzte nicht stornierte Rechnung. Andere ausstehende Rechnungen verhindern nicht, dass das Abonnement in den Status `active` übergeht. - **Alle Rechnungen**: Stripe verhindert, dass das Abonnement in den Status `active` übergeht, solange eine zutreffende ausstehende Rechnung verbleibt. Wenn Sie alle Rechnungen zur Statusauflösung verwenden, gilt Folgendes: - Ein Abonnement mit dem Status `active` wechselt in `past_due`, wenn Stripe eine zutreffende ausstehende Rechnung findet. - Ein Abonnement mit dem Status `past_due` wechselt erst dann in `active`, wenn Sie zutreffende ausstehende Rechnungen begleichen. Ihre [Einstellungen für fehlgeschlagene Zahlungen](https://dashboard.stripe.com/settings/billing/subscriptions#manage-failed-payments) bestimmen weiterhin, ob es nach Abschluss aller Wiederholungsversuche in den Status `canceled` oder `unpaid` übergeht. - Ein Abonnement mit dem Status `unpaid` behält den Status `unpaid`, bis Sie die zutreffenden ausstehenden Rechnungen begleichen. - Ein wieder aufgenommenes Abonnement mit dem Status `paused` geht in den Status `past_due` über, wenn die Rechnung für die Wiederaufnahme beglichen ist, aber eine andere zutreffende Rechnung weiterhin ausstehend ist. Stripe behandelt eine Rechnung als zutreffende ausstehende Rechnung, wenn sie finalisiert wurde, ihre Zahlung fällig ist und sie nicht beglichen wurde. Um eine Rechnung zu begleichen, zahlen Sie sie, stornieren Sie sie oder markieren Sie sie manuell als uneinbringlich. Eine Rechnung, die Stripe nach Beendigung der wiederholten Zahlungsversuche als uneinbringlich markiert, bleibt weiterhin ausstehend. Stripe prüft zutreffende Rechnungen der letzten 37 Monate. Um blockierende Rechnungen zu identifizieren, [listen Sie die Rechnungen des Abonnements auf](https://docs.stripe.com/api/invoices/list.md), deren Status `open` oder `uncollectible` lautet. Eine uneinbringliche Rechnung bleibt nur dann ausstehend, wenn der Grund dafür `max_payment_attempts` oder `payment_not_received` lautet. Andere Gründe, wie beispielsweise `user_forgiven`, verhindern nicht, dass das Abonnement aktiv wird. Um zu ermitteln, welcher Fall zutrifft, überprüfen Sie den [Grund für die Uneinbringlichkeit](https://docs.stripe.com/api/invoices/object.md#invoice_object-status_details-uncollectible-reason). Die Änderung der Einstellung führt nicht sofort zu einer Neubewertung bestehender Abonnements. Die Änderung wird wirksam, wenn Stripe den Abonnementstatus das nächste Mal bewertet, z. B. nach einer Rechnungszahlung oder dem Fehlschlagen einer Zahlung. Die Einstellung ändert nur die Statusauflösung. Ihr Zeitplan für Wiederholungen oder letzte Wiederholungsaktionen ist davon nicht betroffen. ## Zahlungsstatus Ein [PaymentIntent](https://docs.stripe.com/payments/payment-intents.md) verfolgt den Lebenszyklus jeder Zahlung. Immer wenn eine Zahlung für ein Abonnement fällig ist, erstellt Stripe eine [Rechnung](https://docs.stripe.com/billing/invoices/subscription.md) und einen PaymentIntent.Die PaymentIntent-ID wird der Rechnung beigefügt und Sie können über die Objekte „Rechnung” und „Abonnement” darauf zugreifen. Der Status von PaymentIntent wirkt sich auf den Status der Rechnung und des Abonnements aus. Im Folgenden wird erläutert, wie die verschiedenen Ergebnisse einer Zahlung den verschiedenen Status zugeordnet werden: | Zahlungsergebnis | PaymentIntent-Status | Rechnungsstatus | Abonnementstatus | | --- | --- | --- | --- | | Erfolgreich | `succeeded` | `paid` | `active`, sofern die für den Abonnementstatus maßgebende(n) Rechnung(en) beglichen wurde(n); andernfalls bleibt der bestehende Status `past_due` oder `unpaid` bestehen | | Fehlgeschlagen aufgrund eines Kartenfehlers | `requires_payment_method` | `open` | `incomplete` | | Fehlgeschlagen aufgrund von Authentifizierung | `requires_action` | `open` | `incomplete` | ### Zahlungsmethoden mit verzögerter Zahlungsbestätigung Zahlungsmethoden, die den Zahlungsstatus nicht sofort zurückgeben können, wenn Kundinnen und Kunden eine Transaktion versuchen (z. B. ACH Direct Debit), handhaben Statusübergänge bei Abonnements unterschiedlich. Wenn Sie diese Arten von Zahlungsmethoden verwenden, kann ein Abonnement nach der Erstellung direkt zu `aktiv` übergehen und `unvollständig` umgehen. Wenn die Zahlung später fehlschlägt, storniert Stripe die Rechnung, aber das Abonnement bleibt `aktiv`. Berücksichtigen Sie dieses Verhalten, wenn Sie Ihre Zugriffssteuerung und Wiederholungslogik entwerfen. Die folgenden Abschnitte beschreiben die Ergebnisse der ersten Zahlung beim Erstellen eines Abonnements, das eine sofortige Zahlung erfordert. Informationen zu fehlgeschlagenen Zahlungen bei späteren Rechnungen finden Sie unter [Umgang mit fehlgeschlagenen wiederkehrenden Zahlungen](https://docs.stripe.com/billing/subscriptions/overview.md#failed-recurring-payments). ### Erste Zahlung erfolgreich Wenn die erste Abonnementzahlung der Kundin oder des Kunden erfolgreich ist: - Der `status` des PaymentIntent wechselt zu `succeeded`. - Der `status` der Rechnung ist `paid`. - Stripe ermittelt den Abonnementstatus gemäß Ihren [Abonnementeinstellungen](https://dashboard.stripe.com/settings/billing/subscriptions#manage-failed-payments). Das Abonnement geht in den Status `active` über, wenn die Rechnung oder Rechnungen, von der bzw. denen sein Status abhängt, beglichen ist bzw. sind. - Stripe sendet das Ereignis `invoice.paid` an Ihre konfigurierten Webhook-Endpoints. Bei [Zahlungsmethoden](https://docs.stripe.com/payments/payment-methods/integration-options.md) mit längeren Bearbeitungszeiten werden Abonnements sofort aktiviert. In diesen Fällen kann der Status von PaymentIntent so lange für ein `active` Abonnement in `processing` bleiben, bis die Zahlung erfolgreich abgeschlossen ist. Wenn das Abonnement aktiviert ist, [gewähren Sie Zugriff](https://docs.stripe.com/billing/subscriptions/overview.md#provision-access) auf Ihr Produkt. ### Erste Zahlung erfordert eine Zahlungsmethode Wenn die erste Zahlung aufgrund eines [Kartenfehlers](https://docs.stripe.com/api/errors.md#errors-card_error) wie beispielsweise einer [abgelehnten Zahlung](https://docs.stripe.com/declines.md#issuer-declines) fehlschlägt: - Der `status` des PaymentIntent lautet `requires_payment_method`. - Der `status` des Abonnements ist `incomplete`. - Der `status` der Rechnung ist `open`. Gehen Sie wie folgt vor, um diese Probleme zu lösen: - Benachrichtigen Sie die Kundin/den Kunden. - Erfassen Sie neue Zahlungsinformationen und [bestätigen Sie den PaymentIntent](https://docs.stripe.com/api/payment_intents/confirm.md). - Aktualisieren Sie die [Standard-Zahlungsmethode](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-default_payment_method) für das Abonnement. - Stripe versucht die Zahlung erneut mithilfe von [Smart Retries](https://docs.stripe.com/invoicing/automatic-collection.md#smart-retries) oder basierend auf Ihren benutzerdefinierten [Wiederholungsregeln](https://dashboard.stripe.com/account/billing/automatic). - Verwenden Sie das Ereignis [invoice.payment_failed](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md#invoice-payment-failed-webhook), um fehlgeschlagene Abonnementzahlungen zu überwachen und Aktualisierungen der Wiederholungsversuche vorzunehmen. Nach einem Zahlungsversuch für eine Rechnung wird der Wert [next_payment_attempt](https://docs.stripe.com/api.md#invoice_object-next_payment_attempt) anhand der aktuellen Abonnementeinstellungen in Ihrem Dashboard festgelegt. Erfahren Sie, wie Sie [mit fehlgeschlagenen Zahlungen für Abonnements umgehen](https://docs.stripe.com/billing/subscriptions/webhooks.md#payment-failures). ### Umgang mit fehlgeschlagenen wiederkehrenden Zahlungen Wenn eine wiederkehrende Abonnementzahlung fehlschlägt, achten Sie auf `invoice.payment_failed`. [Überwachen Sie Änderungen am Abonnement-Status](https://docs.stripe.com/billing/subscriptions/webhooks.md#state-changes), um Übergänge zu `past_due` oder `unpaid` zu erkennen. Benachrichtigen Sie die Kundin/den Kunden, damit diese/dieser die Zahlungsmethode aktualisieren oder die offene Rechnung bezahlen kann. [Überprüfen Sie Webhook-Signaturen](https://docs.stripe.com/webhooks.md#verify-events), bevor Sie Ereignisse abwickeln. Konfigurieren Sie [Smart Retries oder benutzerdefinierte Wiederholungsregeln](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md), um fehlgeschlagene Zahlungen erneut zu versuchen. Wählen Sie in Ihren [Einstellungen für fehlgeschlagene Zahlungen](https://dashboard.stripe.com/settings/billing/automatic), was mit dem Abonnement nach dem letzten Wiederholungsversuch geschieht. Verwenden Sie die [Tabelle zum Abonnement-Status](https://docs.stripe.com/billing/subscriptions/overview.md#subscription-statuses), um zu ermitteln, wann Sie den Zugriff widerrufen und wie Sie Abonnements mit dem Status `past_due` und `unpaid` reaktivieren können. Weitere Informationen finden Sie unter [Fehlgeschlagene wiederkehrende Abbuchungen](https://docs.stripe.com/billing/collection-method.md#handle-recurring-charge-failures). ### Aktion erforderlich Einige Zahlungsmethoden erfordern die Kundenauthentifizierung mit [3D Secure](https://docs.stripe.com/payments/3d-secure.md) (3DS). Ob eine Authentifizierung erforderlich ist, hängt von Ihren [Radar-Regeln](https://docs.stripe.com/payments/3d-secure/authentication-flow.md#three-ds-radar) und der ausstellenden Bank der Karte ab. Wenn die Zahlung fehlschlägt, weil die Kundin oder der Kunde eine Zahlung authentifizieren muss: - Der `status` des PaymentIntent lautet `requires_action`. - Der `status` des Abonnements ist `incomplete`. - Der `status` der Rechnung ist `open`. Gehen Sie wie folgt vor, um diese Probleme zu lösen: - Überwachen Sie die Ereignisbenachrichtigung `invoice.payment_action_required` mit [Webhook-Endpoints](https://docs.stripe.com/billing/subscriptions/webhooks.md). Dies gibt an, dass eine Authentifizierung erforderlich ist. - Benachrichtigen Sie Ihre Kundinnen und Kunden, dass sie sich authentifizieren müssen. Rufen Sie das Client-Geheimnis des PaymentIntent ab und übergeben Sie es an [stripe.handleNextAction](https://docs.stripe.com/js/payment_intents/handle_next_action). Dies führt Kundinnen und Kunden durch alle erforderlichen Schritte und gibt das Ergebnis an Ihre Anwendung zurück. - Überwachen Sie das Ereignis `invoice.paid` an Ihrem Ereignisziel, um zu überprüfen, ob die Zahlung erfolgreich war. Vergewissern Sie sich vor der Bereitstellung Ihres Produkts, dass das Abonnement `active` ist oder dass der Kunde oder die Kundin über aktive Berechtigungen verfügt. ## See also - [Eine Integration für Abonnements entwerfen](https://docs.stripe.com/billing/subscriptions/design-an-integration.md) - [Eine Abonnement-Integration erstellen](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md) - [Quickstart von Subscriptions](https://docs.stripe.com/billing/quickstart.md)