# So funktionieren Abonnements Verwalten Sie wiederkehrende Zahlungen und Abonnementlebenszyklen. Abonnements ermöglichen es Kundinnen und Kunden, wiederkehrende Zahlungen für den Zugriff auf ein Produkt zu tätigen. Im Gegensatz zu einmaligen Käufen müssen Sie bei Abonnements zusätzliche Kundendaten für zukünftige Zahlungen speichern. Stripe bietet Funktionen, die Ihnen bei der Verwaltung der Abrechnung von Abonnements nützlich sind. - [Support für verschiedene Preismodelle ](https://docs.stripe.com/products-prices/pricing-models.md) - [Abonnement-Rabattverwaltung](https://docs.stripe.com/billing/subscriptions/coupons.md) - [Testphasenverwaltung](https://docs.stripe.com/billing/subscriptions/trials.md) - [Anteilmäßige Verrechnung für geänderte Abonnements](https://docs.stripe.com/billing/subscriptions/prorations.md) - [Kundinnen-/Kundenselbstverwaltung](https://docs.stripe.com/customer-management.md) - [Invoicing zum Einzug von Zahlungen](https://docs.stripe.com/billing/invoices/subscription.md) - [Automatisierte Umsatzsicherung](https://docs.stripe.com/billing/revenue-recovery.md) - [Berichte und Analysen](https://docs.stripe.com/billing/subscriptions/analytics.md) ## Der Lebenszyklus eines Abonnements In den folgenden Abschnitten wird der empfohlene Abonnement-Lifecycle in Stripe beschrieben. ### Abonnement erstellen Sie können ein neues Abonnement im [Dashboard](https://dashboard.stripe.com/subscriptions?status=active) oder über die [API](https://docs.stripe.com/api/subscriptions/create.md) erstellen. Jedes Mal, wenn Sie ein Abonnement erstellen, löst dies ein [Ereignis](https://docs.stripe.com/billing/subscriptions/webhooks.md#events) aus. Überwachen Sie diese Ereignisse mit [Webhook-Endpoints](https://docs.stripe.com/billing/subscriptions/webhooks.md) und stellen Sie sicher, dass Ihre Integration sie ordnungsgemäß verarbeitet. Optional können Sie eine [Testversion](https://docs.stripe.com/billing/subscriptions/trials.md) erstellen, bei der keine Zahlungen für das Abonnement erforderlich sind. In diesem Fall lautet der `status` `trialing`. Nach Ablauf der Testphase geht das Abonnement in den Status `aktive` über und Stripe stellt dem Abo-Kunden die Kosten in Rechnung. #### Zahlungsverhalten Legen Sie das `payment_behavior` eines Abonnements auf [default_incomplete](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-payment_behavior) fest, um fehlgeschlagene Zahlungen und komplexe Zahlungsabläufe wie 3DS besser handhaben zu können. Dadurch werden Abonnements mit dem Status `incomplete` erstellt, wenn eine Zahlung erforderlich ist. So können Sie anschließend Zahlungsinformationen einholen und bestätigen, um das Abonnement zu aktivieren. Wenn Sie `payment_behavior` auf Folgendes festlegen: - `allow_incomplete`: Stripe versucht sofort, die Zahlung für die Rechnung einzuziehen. Schlägt die Zahlung fehl, ändert sich der Status des Abos in `incomplete`. - `error_if_incomplete`: Schlägt die Zahlung fehl, schlägt die Erstellung des Abos vollständig fehl. Abonnements, die Sie im Dashboard erstellen, werden standardmäßig entsprechend der Zahlungsmethode mit dem entsprechenden Zahlungsverhalten versehen. ### Die Rechnung bearbeiten Wenn Sie ein Abo erstellen, erstellt Stripe automatisch eine [Rechnung](https://docs.stripe.com/billing/invoices/subscription.md) mit dem Status `offen`. Ihre Kundin/Ihr Kunde hat etwa 23 Stunden Zeit, um eine erfolgreiche Zahlung durchzuführen. Während dieser Zeit ist der Status des Abos `unvollständig` und der Rechnungsstatus bleibt `offen`. Dieses 23-Stunden-Fenster ist vorhanden, weil Ihre Kundin/Ihr Kunde die erste Zahlung für ein Abonnement in der Regel (*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)) tätigt. Wenn die Kundin/der Kunde nach 23 Stunden wieder zu Ihrer Anwendung zurückkehren, können Sie ein neues Abonnement für sie/ihn erstellen. ### Der/die Kund/in zahlt Wenn Ihre Kundin oder Ihr Kunde die Rechnung bezahlt, wird das Abonnement auf `active` und die Rechnung auf `paid` aktualisiert. Erfolgt keine Zahlung, wird das Abonnement auf `incomplete_expired` aktualisiert und die Rechnung wird `void`. Um zu bestätigen, ob die Rechnung bezahlt wurde: - Richten Sie einen Webhook-Endpoint oder eine andere Art von Ereignisziel ein und warten Sie auf das Ereignis `invoice.paid`. - Prüfen Sie das Abonnementobjekt manuell und suchen Sie nach `subscription.status=active`. Der `status` wird `active`, wenn die Rechnung entweder durch eine automatische Zahlung abgewickelt wurde oder die Kundin/der Kunde manuell bezahlt hat. 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 Sie ein Abonnement für eine Kundin bzw. einen Kunden erstellen, wird für jede mit diesem Produkt verbundene Funktion eine aktive [Berechtigung](https://docs.stripe.com/billing/entitlements.md). Wenn eine Kundin oder ein Kunde auf Ihre Dienste zugreift, verwenden Sie ihre bzw. seine aktiven Berechtigungen, um ihr bzw. ihm Zugriff auf die in ihrem bzw. seinem Abonnement enthaltenen Funktionen zu gewähren. Alternativ können Sie [aktive Abonnements](https://docs.stripe.com/billing/subscriptions/webhooks.md#active-subscriptions) mit Webhook-Ereignissen verfolgen und das Produkt für die Kundin oder den Kunden auf der Grundlage dieser Aktivität bereitstellen. ### 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. Sie können [Abonnementereignisse](https://docs.stripe.com/billing/subscriptions/webhooks.md#events) mit [Webhook Endpoints](https://docs.stripe.com/billing/subscriptions/webhooks.md) für Änderungen am Abonnement verfolgen. So haben Sie beispielsweise die Möglichkeit, eine Kundin oder einen Kunden per E-Mail benachrichtigen, wenn eine Zahlung fehlschlägt, oder den Zugriff einer Kundin oder eines Kunden widerrufen, wenn dieser sein Abonnement kündigt. 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. ### Erste Rechnung aktualisieren Sie können die erste Rechnung für ein Abonnement aktualisieren, wenn die [collection_method](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-collection_method) `send_invoice` ist. Nachdem die Rechnung erstellt wurde, haben Sie eine Stunde Zeit, die Beträge, Posten, Beschreibungen, Metadaten usw. zu aktualisieren. Nachdem die Rechnung fertiggestellt und zur Zahlung an die Kundin/den Kunden gesendet wurde, können Sie sie nicht mehr aktualisieren. Die erste Rechnung für ein Abonnement mit der auf `charge_automatically` eingestellten `collection_method` wird fertiggestellt und sofort abgebucht. Sie können die erste Rechnung nicht aktualisieren, bevor sie fertiggestellt wurde, aber Sie können nachfolgende Rechnungen für Abo Verlängerungen aktualisieren. Sie können auch die erste Rechnung für Abonnementpläne nicht aktualisieren. Die erste Rechnung ist immer offen, unabhängig von der Einzugsmethode. ### Unbezahlte Abonnements bearbeiten Bei Abos mit unbezahlten Rechnungen bleiben die unbezahlten Rechnungen offen, weitere Zahlungsversuche werden jedoch pausiert. Das Abo erstellt weiterhin für jeden Rechnungsstellungszeitraum Rechnungen, die im Status `draft` verbleiben. Um das Abo wieder zu aktivieren: 1. Erfassen Sie ggf. neue Zahlungsinformationen. 1. Aktivieren Sie den automatischen Einzug, indem Sie für Rechnungsentwürfe [auto advance](https://docs.stripe.com/api/invoices/update.md#update_invoice-auto_advance) auf `true` festlegen. 1. [Finalisieren](https://docs.stripe.com/api/invoices/finalize.md) und bezahlen Sie die offenen Rechnungen. Wenn die letzte nicht stornierte Rechnung vor ihrem Fälligkeitsdatum bezahlt wird, wird der Abonnementstatus auf `active` aktualisiert. Als uneinbringlich gekennzeichnete Rechnungen halten das zugrunde liegende Abonnement `active`. Stripe ignoriert bei der Bestimmung des Abonnementstatus stornierte Rechnungen und verwendet stattdessen die letzte nicht stornierte Rechnung. Der `status` des unbezahlten Abonnements hängt von Ihren [Einstellungen für fehlgeschlagene Zahlungen](https://dashboard.stripe.com/settings/billing/automatic) im Dashboard ab. ### 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 oder dessen [Metadaten](https://docs.stripe.com/metadata.md) nicht mehr aktualisieren können. Wenn Ihre Kundin oder Ihr Kunde das Abonnement erneut abschließen möchte, müssen Sie neue Zahlungsinformationen von ihm/ihr 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 eine Kundenauthentifizierung mit [3D Secure](https://docs.stripe.com/payments/3d-secure.md) (3DS), um den Zahlungsvorgang abzuschließen. 3DS schließt das Authentifizierungsverfahren ab. Ob eine Zahlungsmethode eine Authentifizierung erfordert, hängt von Ihren [Radar-Regeln](https://docs.stripe.com/payments/3d-secure/authentication-flow.md#three-ds-radar) und der ausstellenden Bank für die 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) - [Quickstart von Subscriptions](https://docs.stripe.com/billing/quickstart.md) - [Subscription with a fixed price example](https://github.com/stripe-samples/subscription-use-cases/tree/main/fixed-price-subscriptions)