# 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.

Bei Abonnements, bei denen `collection_method` auf `send_invoice` gesetzt ist, sendet Stripe dem Kunden oder der Kundin per E-Mail einen Link zur Rechnung mit einem konfigurierbaren Fälligkeitsdatum. Das Abonnement bleibt so lang`unvollständig`, bis der Kunde oder die Kundin bezahlt hat.

Weitere Informationen finden Sie unter [Rechnungen für Abonnements](https://docs.stripe.com/billing/invoices/subscription.md).

### Zahlung bestätigen

Wenn Ihr Kunde die Rechnung bezahlt, wird der Abonnementstatus auf `aktiv` und der Rechnungsstatus auf `bezahlt` aktualisiert. Achten Sie auf das Ereignis [invoice.paid](https://docs.stripe.com/billing/subscriptions/webhooks.md#events) oder vergewissern Sie sich, dass der Abonnementstatus `aktiv` ist.

Wenn der Kunde oder die Kundin nicht innerhalb von 23 Stunden bezahlt, wird das Abonnement auf `incomplete_expired` gesetzt und die Rechnung wird `ungültig`. Um den Zugriff des Kunden oder der Kundin 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) im Dashboard ab.

Stornierte Rechnungen wirken sich nicht auf den Status des Abonnements aus. Stripe ermittelt den Status aus der letzten nicht stornierten Rechnung. Weitere Informationen finden Sie unter [Fehlgeschlagene Zahlungen für Abonnements](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. Bei `past_due`-Abonnements ändert sich der Status des Abonnements in `aktiv`, wenn die letzte zugehörige Rechnung bezahlt oder als uneinbringlich markiert wird.

`Aktiv` bedeutet nicht, dass alle ausstehenden Rechnungen, die mit dem Abonnement verknüpft sind, bezahlt wurden. Sie können andere ausstehende Rechnungen nach eigenem Ermessen zur Zahlung offen lassen, als uneinbringlich markieren oder stornieren. |
| `incomplete` | Der Kunde/Die Kundin muss innerhalb von 23 Stunden eine erfolgreiche Zahlung tätigen, um das Abonnement zu aktivieren. Oder für die Zahlung ist eine [Aktion erforderlich](https://docs.stripe.com/billing/subscriptions/overview.md#requires-action), wie z. B. die Kundenauthentifizierung. Abonnements können auch `incomplete` sein, wenn eine Zahlung aussteht und der PaymentIntent Status `processing` ist. |
| `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 der letzten *finalisierten* Rechnung ist entweder fehlgeschlagen oder wurde nicht versucht. Das Abonnement erstellt weiterhin Rechnungen. Ihre [Abonnement-Einstellungen](https://dashboard.stripe.com/settings/billing/automatic) im Dashboard bestimmen den nächsten Status des Abonnements. Wenn die Rechnung nach allen versuchten [Smart Retries](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md) weiterhin unbezahlt ist, können Sie das Abonnement so konfigurieren, dass es in `storniert` oder `unbezahlt` übergeht oder den Status `past_due` beibehält.

Um das Abonnement wieder zu aktivieren, bitten Sie Ihre Kundinnen und Kunden, die aktuellste Rechnung zu bezahlen. Der Status des Abonnements ändert sich in `aktiv`, unabhängig davon, ob die Zahlung vor oder nach dem Fälligkeitsdatum der letzten Rechnung erfolgt. |
| `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` | Die letzte Rechnung wurde noch nicht bezahlt, aber das Abonnement wird noch fortgesetzt. Die letzte Rechnung bleibt offen und es werden weiterhin Rechnungen generiert, allerdings wird kein Zahlungsversuch unternommen. Widerrufen Sie den Zugriff auf Ihr Produkt, wenn das Abonnement `unpaid` ist, da im Status `past_due` bereits versucht und wiederholt wurde. Um das Abonnement auf `active` zu setzen, bezahlen Sie die letzte Rechnung vor dem Fälligkeitsdatum. |
| `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). |

## 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` |
| 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 erläutern diese Status und die entsprechenden Aktionen, die dafür ausgeführt werden müssen.

### Zahlung erfolgreich

Bei erfolgreicher Zahlung durch die Kundin bzw. den Kunden:

- Der `status` des PaymentIntent wechselt zu `succeeded`.
- Der `status` des Abonnements ist `active`.
- Der `status` der Rechnung ist `paid`.
- 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.

Nachdem Ihr Abonnement nun aktiviert ist, [gewähren Sie Zugriff](https://docs.stripe.com/billing/subscriptions/overview.md#provision-access) auf Ihr Produkt.

### Zahlungsmethode erforderlich

Wenn die Zahlung aufgrund eines [Kartenfehlers](https://docs.stripe.com/api/errors.md#errors-card_error) wie 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).

### Handle failed recurring payments 

When a recurring subscription payment fails, listen for `invoice.payment_failed`. [Monitor subscription status changes](https://docs.stripe.com/billing/subscriptions/webhooks.md#state-changes) to detect transitions to `past_due` or `unpaid`. Notify the customer so they can update their payment method or pay the open invoice. [Verify webhook signatures](https://docs.stripe.com/webhooks.md#verify-events) before you process events.

Configure [Smart Retries or custom retry rules](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md) to retry failed payments. In your [failed payment settings](https://dashboard.stripe.com/settings/billing/automatic), choose what happens to the subscription after the final retry. Use the [subscription status table](https://docs.stripe.com/billing/subscriptions/overview.md#subscription-statuses) to determine when to revoke access and how to reactivate `past_due` and `unpaid` subscriptions. See [Failed recurring charges](https://docs.stripe.com/billing/collection-method.md#handle-recurring-charge-failures) for more details.

### 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. Nutzerinnen und Nutzer können Ihre Anwendung verlassen, bevor `handleNextAction()` abgeschlossen ist. Durch die Überprüfung, ob die Zahlung erfolgreich war, können Sie Ihr Produkt korrekt bereitstellen.

## 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)