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

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.

Stripe ignoriert ungültig gewordene Rechnungen bei der Ermittlung des Abonnementstatus und verwendet stattdessen die letzte nicht ungültig gewordene Rechnung.

Weitere Informationen finden Sie unter [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 Abo ist in gutem Zustand. Bei `past_due`-Abos führt die Zahlung der zuletzt zugehörigen Rechnung oder deren Kennzeichnung als uneinbringlich dazu, dass das Abo auf `active` wechselt. Beachten Sie, dass `active` nicht bedeutet, dass alle ausstehenden Rechnungen des Abos beglichen sind. Sie können andere ausstehende Rechnungen offen lassen, sie als uneinbringlich kennzeichnen oder sie nach eigenem Ermessen 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 latest *finalized* invoice ist entweder fehlgeschlagen oder wurde nicht versucht. Das Abonnement erstellt weiterhin Rechnungen. Ihr Dashboard [Abonnementeinstellungen](https://dashboard.stripe.com/settings/billing/automatic) bestimmt den nächsten Status des Abonnements. Wenn die Rechnung nach allen versuchten [Smart Retries](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md) immer noch unbezahlt ist, können Sie das Abonnement so konfigurieren, dass es in den Status `canceled`, `unpaid` übergeht oder als `past_due` belassen wird. Um das Abonnement zu reaktivieren, lassen Sie Ihre Kundinnen und Kunden die letzte Rechnung bezahlen. Der Status des Abonnements wird `active`, 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` |

Asynchrone Zahlungsmethoden wie ACH Direct Debit verarbeiten Status-Übergänge des Abos anders als sofortige Zahlungsmethoden. Wenn Sie eine asynchrone Zahlungsmethode verwenden, kann ein Abo nach der Erstellung direkt in den Status `aktiv` wechseln und `unvollständig` umgehen. Schlägt die Zahlung später fehl, storniert Stripe die Rechnung, aber das Abo bleibt `aktiv`. Verwenden Sie dieses Verhalten, wenn Sie Ihre Zugriffskontroll- 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).

### 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 Kundin/den Kunden, dass er/sie eine Authentifizierung durchführen muss.
- Rufen Sie das Client-Geheimnis für den PaymentIntent ab und übergeben Sie es in einem Aufruf an [stripe.ConfirmCardPayment](https://docs.stripe.com/js/payment_intents/confirm_card_payment). Dadurch wird Ihren Kundinnen und Kunden ein Modal zur Authentifizierung angezeigt, die Zahlung wird versucht, dann wird das Modal geschlossen und der Kontext an Ihre Anwendung zurückgegeben.
- Überwachen Sie das Ereignis `invoice.paid` auf Ihrem Ereignisziel, um zu erfahren, ob die Zahlung erfolgreich war. Es kann vorkommen, dass Nutzer/innen Ihre Anwendung verlassen, bevor `confirmCardPayment()` abgeschlossen wurde. Durch die Überprüfung des Zahlungserfolgs können Sie eine korrekte Bereitstellung des Produkts sicherstellen.

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