Stripe-Abonnementabrechnung

Lesen Sie dies zuerst

Falls Sie den Stripe-Webhook noch nicht eingerichtet haben, beginnen Sie mit Einrichten Stripe-Webhook. Diese Seite erklärt den vollständigen Abrechnungsfluss Stripe-Abonnements, nachdem Ihr Webhook verkabelt ist.

Stripe-Abrechnung in Booknetic SaaS hängt von zwei Teilen ab, die zusammenarbeiten:

• Stripe sammelt die Kartenzahlung, speichert die Karte, erstellt das Abonnement, erneuert Rechnungen, versucht fehlgeschlagene Zahlungen erneut und sendet Zahlungsquittungen.
• Booknetic SaaS sendet Tenants an Stripe Checkout, speichert das Abonnementergebnis, aktualisiert den Tarif und das Ablaufdatum des Tenants und lauscht auf Stripe-Webhook-Events.

In klarem Deutsch: Stripe besitzt die Zahlung; Booknetic SaaS spiegelt den Abonnementzustand wider, den Ihr Mandant innerhalb der SaaS-Plattform benötigt.

Bevor Sie beginnen

Bevor Sie bezahlte Stripe-Abonnements akzeptieren, stellen Sie sicher, dass Sie Folgendes haben:

1. Stripe in Booknetic SaaS → Settings → Payment methods aktiviert.
2. Ihr Stripe Publishable key und Secret key in Booknetic SaaS gespeichert.
3. Ein funktionierender Stripe-Webhook-Endpunkt, der mit Ihrer Seite verbunden ist.
4. Die erforderlichen Webhook-Events, die in Stripe ausgewählt wurden:

invoice.paid
customer.subscription.deleted

Der Webhook ist für die Abrechnung des Abonnements nicht optional. Die erste Zahlung kann erfolgreich aussehen, weil der Mandant von Stripe Checkout zurückkehrt, aber Verlängerungen und Kündigungsupdates hängen vom Webhook ab.

Für die Einrichtungsschritte des Webhooks verwenden Sie den Begleitleitfaden: Einrichten Stripe-Webhook.

Das Stripe-Abrechnungsmodell in einem Fluss

Ein Stripe-Abonnement in Booknetic SaaS folgt diesem Weg:

Mandant wählt einen Tarif
→ Stripe Checkout wird geöffnet
→ Mandant gibt die Karte ein
→ Stripe erstellt das Abonnement und die erste Rechnung
→ Stripe sendet den invoice.paid-Webhook
→ Booknetic SaaS aktiviert oder verlängert den Mandantentarif
→ Stripe wiederholt den Rechnungszyklus am nächsten Verlängerungsdatum

Das wichtige Detail ist, dass Stripe und Booknetic SaaS nicht dasselbe speichern.

Stripe speichert

Booknetic SaaS speichert

Kundenkarte und Zahlungsmethode

Mandantentarif und Ablaufdatum

Stripe Kunde

Mandantenkonto

Stripe-Abonnement

Referenz für aktive Abonnements

Stripe Rechnung

Billing-/Zahlungshistorie-Referenz

Erneuerungsplan und Logik für Wiederholungen

Ob der Mandant SaaS-Zugang haben sollte

Diese Trennung ist normal. Das bedeutet, dass Kartenverwaltung, Quittungen, Rückzahlungen und Rückerstattungen in Stripe stattfinden, während der Zugriff auf den Tarif und das Ablauf des Mandanten in Booknetic SaaS stattfinden.

Mandantenanmeldung und erste Zahlung

Wenn ein Mandant einen kostenpflichtigen Tarif auswählt und per Karte zahlt, schickt Booknetic SaaS ihn an Stripe Checkout.

Der Mandantenablauf sieht so aus:

1. Der Mandant öffnet Billing in seinem Mandantenpanel.
2. Der Mandant wählt einen Tarif und einen Abrechnungszyklus, wie monatlich oder jährlich.
3. Der Mandant wählt die Kartenzahlung aus.
4. Stripe Checkout öffnet sich im Browser.
5. Der Mandant gibt seine Kartendaten auf der sicheren Seite von Stripe ein.
6. Stripe erfasst die erste Zahlung und erstellt das Abonnement.
7. Stripe leitet den Mandanten zurück zu Booknetic SaaS.
8. Booknetic SaaS markiert die Abrechnungszeile als abbezahlt, speichert die aktive Abonnementreferenz und aktualisiert das Ablaufdatum des Mandanten.

Booknetic SaaS speichert nicht die vollständige Kartennummer des Mandanten. Kartendaten werden auf Stripe Seite eingegeben und gespeichert.

Wiederkehrender Erneuerungsfluss

Nach der ersten Zahlung setzt Stripe das Abonnement automatisch fort.

An jedem Verlängerungsdatum:

1. Stripe erstellt die nächste Abonnementrechnung.
2. Stripe belastet die gespeicherte Karte.
3. Wenn die Ladung erfolgreich ist, sendet Stripe den invoice.paid Webhook an Ihre Booknetic SaaS Website.
4. Booknetic SaaS dokumentiert die bezahlte Verlängerung und verlängert das Ablaufdatum des Mandanten.

Wenn der Webhook fehlt, falsch ist oder abgelehnt wird, kann Stripe die Rechnung als bezahlt anzeigen, während Booknetic SaaS den Zeitraum des Mandanten nicht verlängert. In diesem Fall reparieren Sie zuerst den Webhook und überprüfen Sie dann den betroffenen Mandanten.

Kündigungsfluss

Bei der Kündigung ist es besonders wichtig zu verstehen, welches System was besitzt.

Kündigung in Booknetic SaaS

Wenn ein Abo aus dem Abrechnungsstrom Booknetic SaaS gekündigt wird, sendet Booknetic SaaS eine Kündigungsanfrage an Stripe für das aktive Abonnement.

Nachdem Stripe das Abonnement gelöscht oder gekündigt hat, schickt Stripe dieses Webhook-Event an Booknetic SaaS zurück:

customer.subscription.deleted

Booknetic SaaS löscht dann die aktive Abonnementreferenz und markiert den Mandanten im SaaS-Abrechnungszustand als abgemeldet/gekündigt.

Eine Kündigung ist nicht dasselbe wie die Löschung des Mandanten. Das Mandantenkonto und die Mandantendaten bleiben bestehen, es sei denn, Sie löschen den Mandanten separat. Für die sichere Reihenfolge für Kündigung und Löschung siehe Wie man einen Mandanten in Booknetic SaaS kündigt oder löscht.

Mandanteninitiierte Kündigung und Kartenupdates

Booknetic SaaS bietet derzeit nicht einen Stripe Customer Portal-Button für Mandant an.

Das bedeutet, dass Mandant diese Stripe Aktionen nicht über ein Stripe-gehostetes Portal innerhalb Booknetic SaaS selbst bedienen können:

• die gespeicherte Karte zu aktualisieren;
• alle Stripe-Rechnungen von einem Portal ansehen oder herunterladen;
• die Rechnungsadresse von einem Stripe-Portal zu ändern;
• Ein Abonnement von einem Stripe-Portal pausieren.

Wenn ein Mandant eine andere Karte verwenden möchte, wählen Sie eine dieser Optionen:

1. Bitten Sie den Mandanten, das aktuelle Abonnement zu kündigen und denselben Tarif erneut abzuschließen. Die neue Stripe Checkout Sitzung erlaubt es ihnen, eine neue Karte einzutragen.
2. Helfen Sie dem Mandanten aus Ihrem Stripe Dashboard, wenn Sie die Abrechnung manuell verwalten.

Bitten Sie Mandant nicht, in Booknetic SaaS nach einem Stripe Customer Portal Link zu suchen, denn dieses Self-Service-Portal ist derzeit nicht angeschlossen.

Was Stripe-Abonnementzustände bedeuten

Stripe kann einen Abonnementzustand anzeigen, der nicht genau wie der Mandantenstatus aussieht, den Sie in Booknetic SaaS sehen. Verwenden Sie diese Tabelle beim Vergleich der beiden.

Stripe Status

Was es in Stripe bedeutet

Was kann man in Booknetic SaaS

incomplete

Das Abonnement wurde erstellt, aber die erste Rechnung wurde bisher nicht erfolgreich bezahlt.

Booknetic SaaS sollten den Tarif nicht als vollständig bezahlt betrachten, bis die Zahlung erfolgreich ist. Der Mandant kann in seinem vorherigen, probierlichen, abgelaufenen oder nicht abgeschlossenen Status bleiben.

active

Das Abonnement wird planmäßig bezahlt.

Der Mandant sollte einen aktiven Tarif und ein Ablaufdatum basierend auf der zuletzt bestätigten Zahlung haben.

past_due

Die letzte Rechnung ist gescheitert und Stripe versucht es gemäß Ihren Stripe-Einstellungen erneut.

Booknetic SaaS folgt nicht Stripe Wiederholungsplan. Der Mandant kann den Zugriff behalten, bis der aktuelle bezahlte Zeitraum endet, aber der Ablauf verlängert sich erst, wenn ein invoice.paid Webhook empfangen wird.

unpaid

Stripe hat aufgehört, es erneut zu versuchtn, oder betrachtet die Rechnung unter Ihren Stripe-Einstellungen als nicht einziehbar.

Booknetic SaaS verlängert den Mandantenzeitraum nicht ohne bezahlte Rechnung. Wenn das Ablaufdatum des Mandanten überschreitet, folgt der Zugang Ihrem abgelaufenen Tarif.

canceled

Das Abonnement wurde Stripe gekündigt oder gelöscht.

Nachdem der customer.subscription.deleted Webhook akzeptiert wurde, löscht Booknetic SaaS die aktive Abonnementreferenz und behandelt den Mandanten als abgemeldet/gekündigt.

Die Schlüsselregel ist einfach: erfolgreiche Zahlungen verlängern den Zugang; Fehlgeschlagene Zahlungen tun das nicht. Stripe kann fehlgeschlagene Zahlungen erneut versuchtn, aber Booknetic SaaS verlängert den Zugriff des Mandanten nur, wenn ein erfolgreiches Zahlungsereignis erhält.

Fehlgeschlagene Zahlungen und Löschungen

Mahnwesen bezeichnet den Prozess der Rückforderung bei fehlgeschlagenen Zahlungen: Wiederholungen, E-Mails bei fehlgeschlagener Zahlung, Erinnerungen und endgültige Inkassoregeln.

Bei Stripe-Abonnements wird das Mahnwesen von Stripe geregelt, nicht von Booknetic SaaS.

Booknetic SaaS sendet keine eingebauten "Ihre Zahlung fehlgeschlagen"-E-Mails an Mandant wegen Stripe-Abonnementausfällen. Wenn Sie möchten, dass Mandant Erinnerungen wegen ausgeschlossener Zahlungen erhalten, konfigurieren Sie das in Ihrem Stripe Dashboard mit den Abrechnungs- und E-Mail-Einstellungen von Stripe.

Booknetic SaaS hört auf erfolgreiche bezahlte Rechnungen und Kündigungen von Abonnements. Es ersetzt nicht Stripe-eigene Tools zur Wiederherstellung von fehlgeschlagenen Zahlungen.

Für Stripe-eigene Abonnementkonzepte und Wiederholungsverhalten siehe Stripe-Abonnementübersicht: https://docs.stripe.com/billing/subscriptions/overview

Stripe Produktsynchronisation für Tarife

Wenn Sie in Booknetic SaaS bezahlte Tarife erstellst oder bearbeitest, kannst Booknetic den Tarif als Stripe Produkt/Preis auf Stripe synchronisieren, sodass die Checkout den korrekten Tarif berechnet und den richtigen Zyklus berechnet.

Im normalen Gebrauch müssen Sie Stripe Produkte nicht für jeden Booknetic SaaS Tarif von Hand anfertigen. Konfigurieren Sie Ihre Tarife in Booknetic SaaS und lassen Sie dann den Stripe Checkout-Flow die Produkt-/Preisdaten verwenden, die Booknetic erstellt.

Für Details zur Planeinrichtung, einschließlich Fähigkeiten, Grenzen, Standardplänen und versteckten Plänen, siehe Plans und Planfunktionen in Booknetic SaaS.

Hinweis: Wenn Sie einen Plannamen ändern, kann die Produktbezeichnung in Stripe künftig aktualisiert werden, aber historische Stripe-Rechnungen werden nicht umgeschrieben. Behandle alte Rechnungen als Buchhaltungsunterlagen, die die Details vom Zeitpunkt ihrer Erstellung behalten.

Testmodus und Live-Modus

Stripe Testmodus und Live-Modus sind getrennte Umgebungen.

Wenn Ihr Stripe-Konto im Testmodus ist, aber Ihr Booknetic SaaS Standort aktiv ist, werden echte Mandant nicht erfolgreich belastet. Stellen Sie sicher, dass Ihre Live-SaaS-Seite Live-Stripe-Schlüssel verwendet:

• pk_live_... für die Publishable key;
• sk_live_... für die Secret key;
• Das Live-Webhook-Signierungsgeheimnis für den Live-Webhook-Endpunkt.

Wenn Sie vom Testmodus in den Live-Modus wechselst, aktualisiere die Schlüssel in Booknetic SaaS und erstelle/prüfe den passenden Live-Webhook-Endpunkt in Stripe. Testmodus-Webhook-Geheimnisse und Live-Mode-Webhook-Geheimnisse sind nicht austauschbar.

API-Versionshinweis

Die aktuelle Booknetic SaaS Stripe-Integration verwendet eine Stripe API-Version, die kompatibel ist mit:

2025-07-30.basil

Die meisten Kunden müssen deshalb nichts ändern. Wenn Stripe-Webhook-Ereignisse erfolgreich ausgeliefert werden, die Verlängerungen aber in Booknetic SaaS nicht aktualisiert werden, wenden Sie sich an den Support mit der Stripe-Ereignis-ID und dem betroffenen Mandanten, damit die Nutzlast überprüft werden kann.

Häufige Fragen

Wie erstatte ich einem Mandanten das Geld?

Bearbeiten Sie die Rückerstattung in Ihrem Stripe Dashboard.

Booknetic SaaS passt nach einer Stripe Rückerstattung nicht automatisch das Ablaufdatum des Mandanten, den Planzeitraum oder den Abrechnungszugang an. Wenn Sie einem Mandanten eine Rückerstattung erstatten, prüfen Sie, ob Sie diesen Mandant auch manuell in Booknetic SaaS anpassen müssen.

Beispiel: Wenn Sie eine Verlängerung erstatten, aber möchten, dass der Mandant den Zugang bis zu einem bestimmten Datum behält, prüfen Sie nach der Rückerstattung den Tarif und den Ablaufstatus des Mandanten.

Kann ein Mandant sein Abonnement pausieren?

Es gibt keinen nativen Pausenfluss in Booknetic SaaS für Stripe-Abonnements.

Die praktischen Optionen sind:

• das Abonnement kündigen und den Mandanten später erneut abonnieren lassen;
• eine außergewöhnliche Pause manuell in Stripe durchführen und den Mandantenstatus bei Bedarf manuell anpassen.

Beschreiben Sie dies nicht als eingebaute Pausefunktion, es sei denn, Ihre Produktversion fügt später eine hinzu.

Was, wenn Stripe past_due sagt, der Mandant aber in Booknetic SaaS noch aktiv aussieht?

Das kann passieren.

past_due bedeutet, dass Stripe die fehlgeschlagene Rechnung erneut versucht. Booknetic SaaS kann den Mandanten trotzdem als aktiv anzeigen, weil der Mandant bereits für den aktuellen Zeitraum bezahlt hat. Wenn Stripe später Erfolg hat, verlängert der invoice.paid Webhook den Ablauf. Wenn Stripe nie erfolgreich ist, erhält der Mandant die nächste Verlängerung nicht.

Schau Ihnen beide Orte an:

1. Stripe-Abonnement-/Rechnungszustand.
2. Ablaufdatum des Mandanten in Booknetic SaaS.

Warum hat eine Verlängerungszahlung das Ablaufdatum des Mandanten nicht verlängert?

Verlängerungen erreichen Booknetic SaaS über den invoice.paid Webhook.

Prüfen:

• die Webhook-URL korrekt ist;
• der Endpunkt auf invoice.paid abonniert ist;
• das Webhook-Signing-Geheimnis in Booknetic SaaS aktuell ist;
• Stripe zeigt eine erfolgreiche 2xx-Lieferung für das Rechnungsereignis.

Wenn das alles korrekt aussieht, kontaktieren Sie den Support mit der Stripe-Ereignis-ID und dem betroffenen Mandanten.

Warum bekommt mein Mandant nach der ersten Zahlung keine E-Mail?

Zahlungsbelege und viele Abrechnungs-E-Mails werden durch Stripe Einstellungen gesteuert.

Booknetic SaaS Workflow-Benachrichtigungen sind getrennt. Wenn Sie nach Subscription-Events eine Mandant-E-Mail von Booknetic möchten, überprüfen Sie Ihre Booknetic SaaS Workflow-Events und Benachrichtigungseinrichtungen. Wenn Sie Stripe Empfangs- oder Fehlzahlungs-E-Mails möchten, konfigurieren Sie sie in Stripe.

Kann ich manuell eine Rechnung in Stripe erstellen und Booknetic SaaS den Mandanten verlängern lassen?

Nein, nicht automatisch.

Manuell erstellte Stripe-Rechnungen sind in Booknetic SaaS nicht der normale Abonnement-Verlängerungspfad. Wenn Sie einem Mandanten manuell in Stripe Rechnung stellen, aktualisieren oder überprüfen Sie auch den Mandantenstatus manuell in Booknetic SaaS.

Können Mandanten ihre Karte aktualisieren, ohne zu kündigen?

Im Moment nicht über Booknetic SaaS, weil Stripe Customer Portal nicht an das Mandantenpanel angeschlossen ist.

Nutzen Sie den Kündigungs- und Wiederabonnierungs-Flow oder helfen Sie dem Mandanten von der Stripe Dashboard aus, wenn Sie die Abrechnung direkt verwalten.

Fehlerbehebungs-Checkliste

Die erste Zahlung erfolgte in Stripe, aber der Mandant wurde nicht aktiviert

Prüfen:

• der Mandant erfolgreich aus Stripe Checkout zurückkehrte;
• der Stripe-Webhook konfiguriert wird;
• Das Webhook-Geheimnis wird in Booknetic SaaS gespeichert;
• die Stripe-Event-Lieferung brachte 200 Exemplare zurück;
• Der Mandant wählte den vorgesehenen Tarif und den Abrechnungszyklus aus.

Wenn die erste Rechnung nie bezahlt wurde, kann das Stripe-Abonnement incomplete bleiben. In diesem Fall sollten Booknetic SaaS den kostenpflichtigen Tarif noch nicht aktivieren.

Die Verlängerung wird in Stripe bezahlt, aber Booknetic SaaS zeigt immer noch den alten Ablauf an.

Das ist meist ein Webhook-Problem.

Beheben Sie zuerst den Webhook und überprüfen Sie dann den betroffenen Mandanten. Der Begleit-Webhook-Guide behandelt das Setup: Einrichten Stripe-Webhook.

Der Mandant sagt, er habe seine Abrechnungs-E-Mail geändert, aber Stripe Quittungen gehen weiterhin auf die alte E-Mail

Stripe erhält die Mandant-E-Mail, wenn die Auszahlungssitzung erstellt wird. Wenn der Mandant später seine E-Mail innerhalb Booknetic SaaS ändert, wird die bereits im Stripe-Abonnement/Kunden gespeicherte E-Mail nicht automatisch aktualisiert.

Aktualisieren Sie die Abrechnungs-E-Mail in Stripe, falls der Mandant zukünftige Stripe Quittungen woanders schicken möchte.

Mandant hat gekündigt, aber sie wurden erneut belastet

Überprüfen Sie die Stripe-Abonnementzeit.

Häufige Ursachen:

• die endgültige Rechnung vor der Kündigung ausgestellt wurde;
• die Kündigung nicht Stripe erreichte;
• der customer.subscription.deleted Webhook erreichte Booknetic SaaS nicht;
• Der Mandant wurde gelöscht, bevor die Anbieterkündigung überprüft wurde.

Verwenden Sie den Kündigungsleitfaden, bevor Sie Mandanten löschen: Wie man einen Mandanten in Booknetic SaaS kündigt oder löscht.

Verwenden Sie 3–5 Booknetic-seitige Screenshots bei der Vorbereitung der veröffentlichten Seite.

Empfohlene Fangungen:

1. Booknetic SaaS → Settings → Payment methods → Stripe Abschnitt zeigt die Felder Publishable key, Secret key und Webhook secret, wobei alle empfindlichen Werte verschwommen sind.
2. Booknetic SaaS → Plans → Tarif-Editor, der bezahlte monatliche/jährliche Preise oder Stripe-bezogene Tarif-Synchronisationskontext anzeigt, falls sichtbar in der Benutzeroberfläche.
3. Mandant-Panel → Billing zeigt Plankarten und Karte/Stripe Zahlungsoption vor dem Checkout.
4. Mandantenpanel → Billing → aktueller Tarif-/Abonnementstatus zeigt den aktiven Tarif und das Ablauf nach erfolgreicher Zahlung.
5. Mandantenpanel → Billing → Cancel subscription Knopf zeigt an, wo die Kündigung beginnt.

Nicht erfassen:

• Stripe Dashboard Abonnementlisten;
• Stripe Dashboard Rechnungsdetails;
• Stripe-Webhook-Lieferbildschirme;
• Stripe Checkout Seiten;
• jede Seite, die Karten-, Kunden-, Geheimschlüssel-, Webhook-Geheim- oder Live-Abrechnungsdaten offenlegt.

Für Stripe-eigene Benutzeroberfläche verlinken Sie stattdessen auf die eigene Dokumentation von Stripe: https://docs.stripe.com/billing/subscriptions/overview

Revision 2026-05-30: TASK-3211 link prefix correction; draft-side only, no Marketing API call.