Abonnementstatus und Abrechnungshistorie

Erklärt die Abonnementstatus in Booknetic SaaS, was lokal gespeichert wird und welche Abrechnungsdetails bei Stripe, PayPal oder WooCommerce liegen.

Version:
Kategorien

Was der Abonnementstatus in Booknetic SaaS bedeutet

In Booknetic SaaS hat jeder Mandant auf Ihrer Plattform einen Abonnementstatus – ein kurzer Label, das Ihnen auf einen Blick zeigt, wo er finanziell steht: Befindet er sich in einer Testphase, bezahlt er Sie regelmäßig, hat er gekündigt, ist sein Zugang abgelaufen oder hat er die Anmeldung noch nicht abgeschlossen?

Der Abonnementstatus ist die nützlichste einzelne Spalte auf Ihrer Tenants-Liste. Damit erkennen Sie kündigende Kunden, finden Testbenutzer, die nie konvertiert haben, und bestätigen, dass Ihre zahlenden Mandanten tatsächlich aktuell sind.

Einige Dinge sind im Voraus wissenswert:

  • Der Abonnementstatus wird berechnet, nicht als einzelnes Enum gespeichert. Booknetic SaaS speichert eine kleine Aufzeichnung für jeden Mandanten – welchen Tarif sie haben, wann ihr Zugang endet, ob sie ein aktives Abonnement bei Ihrem Zahlungsanbieter haben und ob ihre E-Mail verifiziert ist. Das Label, das Sie sehen ("Subscribed", "Expired" usw.), wird jedes Mal aus diesen Feldern abgeleitet, wenn Sie die Tenants-Liste öffnen.
  • Ihr Zahlungsanbieter ist die Quelle der Wahrheit für das Geld. Booknetic SaaS spiegelt genügend Status wider, um den Zugang zu sperren und Ihnen zu zeigen, wer bezahlt hat – aber Stripe, PayPal und WooCommerce führen jeweils die vollständigen Aufzeichnungen über Rechnungen, Rückerstattungen und Mahnversucht auf ihrer Seite. Wir werden dies im Abschnitt "Was in Booknetic SaaS gespeichert ist vs. was bei Ihrem Anbieter liegt" unten ehrlich behandeln.
  • Statusänderungen sind ereignisgesteuert. Wenn ein Mandant abonniert, verlängert, kündigt oder sein Abonnement endet, fließt die Änderung über einen Webhook von Ihrem Anbieter zu Booknetic SaaS. Wenn der Webhook nicht korrekt angeschlossen ist, kann Booknetic SaaS von der Realität abweichen – siehe Einrichten des Stripe-Webhooks für die häufigste Ursache von Abweichungen.

Die Status, die Sie in der Tenants-Liste sehen werden

Booknetic SaaS zeigt vier Statuslabels in Ihrer Tenants-Liste. Hier ist, was jedes in einfachem Englisch bedeutet und was typischerweise für den Mandanten passiert, wenn Sie es sehen.

Statuslabel

Bedeutung

Typische Situation

Subscribed

Der Mandant hat ein aktives Abonnement bei Ihrem Zahlungsanbieter, und sein Zugang ist noch nicht abgelaufen.

Sie bezahlen Sie monatlich oder jährlich oder werden von ihrem Guthabenkonto finanziert und haben genug Guthaben, um die Erneuerung fortzusetzen.

Expired

Der Mandant hat (oder hatte) ein Abonnement bei Ihrem Anbieter, aber sein Zugangszeitraum ist verstrichen und keine Verlängerungszahlung ist eingegangen.

Eine Verlängerungszahlung ist fehlgeschlagen, der Mandant hat gekündigt und der bezahlte Zeitraum ist abgelaufen oder eine Testphase endete ohne Upgrade.

Not activated

Der Mandant hat sich angemeldet, aber seine E-Mail nie verifiziert.

Sie haben das Anmeldeformular begonnen, nie auf den Verifizierungslink geklickt und können sich derzeit nicht in ihr Mandantenpanel einloggen.

Not subscribed

Der Mandant hat seine E-Mail überprüft, hat aber kein Live-Abonnement.

Ein Mandant, dessen Abonnement gekündigt wurde und der bezahlte Zeitraum jetzt ebenfalls vorbei ist, oder ein anderer Status, in dem die Prüfung hinter sich ist, aber noch nicht bezahlt wurde.

Ein fünftes Label, von dem Sie oft hören – Testphase – ist ein Sonderfall von "Subscribed": Der Mandant ist auf dem von Ihnen in Booknetic SaaS → Settings → Tarif Settings konfigurierten Testplan, sein Zugriffsfenster ist das von Ihnen festgelegte Testzeitraum, und er hat noch nicht bezahlt. Die Tenants-Liste zeigt Testmandanten unter demselben Subscribed-Label, bis deren Testphase abläuft; danach wechseln sie zu Expired. Für den vollständigen Testablauf siehe Trials in Booknetic SaaS.

Wichtig: Booknetic SaaS hat nicht das Etikett "Paused", "Ist überfällig" oder "Mahnwesen". Wenn Ihr Zahlungsanbieter ein Abonnement in Mahnwesen (Stripe past_due, PayPal erneut versuchtn) einlegt und die Verlängerung noch nicht erfolgreich oder endgültig gescheitert ist, wird Booknetic SaaS den Mandanten weiterhin als abonniert angezeigt, bis die Verlängerung entweder erfolgreich ist (die Laufzeit verlängert) oder das Abonnement vollständig gekündigt wird. Für Einblick in die Inflight-Mahnwesen prüfen Sie direkt Ihre Stripe Dashboard → Abonnements oder PayPal → Aktivitäten.

Wie ein Mandant zwischen Status wechselt

Tenants wechseln zwischen Status basierend auf Ereignissen, die bei der Anmeldung, auf deren Billing-Seite oder – am häufigsten – bei Ihrem Zahlungsanbieter, wenn ein Webhook ausgelöst wird.

Die untenstehende Tabelle zeigt den Zustand, in dem sie sich befanden, das Ereignis passierte** und den Zustand, in dem sie sich letztlich befanden. Das ist das vollständige Bild, wie sich der Abonnementzustand auf Ihrer Plattform verändert.

Vom Staat

Veranstaltung

Um zu erklären

Woher das Ereignis stammt

(neue Anmeldung)

Mandant reicht das Anmeldeformular ein, E-Mail-Adresse noch nicht verifiziert

Not activated

Booknetic SaaS Anmeldefluss

Not activated

Mandant klickt auf den Link zur E-Mail-Verifizierung

Subscribed (im Testplan, falls Sie eine Testversion eingerichtet haben) oder Not subscribed (wenn keine Testversion)

Booknetic SaaS Verifikationsfluss

Subscribed (Testversion)

Der Mandant wählt in Billing einen bezahlten Tarif und zahlt

Subscribed (mit kostenpflichtigem Tarif)

Seite Billing des Mandanten → Stripe / PayPal / Saldo

Subscribed (Testversion)

Die Testdauer verläuft ohne Upgrade

Expired

Zeitbasiert, kein Ereignis nötig

Subscribed (kostenpflichtig)

Erfolgreiche Erneuerung

Subscribed (Zeitraum)

Webhook: Stripe invoice.paid / PayPal PAYMENT.SALE.COMPLETED

Subscribed (kostenpflichtig)

Der Mandant klickt auf Cancel subscription auf seiner Billing-Seite

Subscribed bis zum Ablauf des Zeitraums, dann abgelaufen

Mandantenaktion → Kündigung an den Anbieter weitergeleitet

Subscribed (kostenpflichtig)

Inhaber kündigt über einen SaaS-Admin oder über das Dashboard des Anbieters

Subscribed bis zum Ablauf des Zeitraums, dann abgelaufen

Eigentümermaßnahme → Kündigung an den Anbieter weitergeleitet

Subscribed (bezahlt)

Erneuerungszahlung schlägt fehl und das Mahnwesen des Anbieters gibt auf

Expired

Webhook: Stripe customer.subscription.deleted / PayPal BILLING.SUBSCRIPTION.CANCELLED

Subscribed (bezahlt)

Mandant wechselt Tarif (Upgrade/Downgrade)

Subscribed (auf neuem Tarif, neue Periode)

Seite des Mandanten Billing → neue Zahlung bestätigt

Expired

Mandant kommt zurück und abonniert erneut von Billing

Subscribed (auf gewähltem Tarif)

Seite des Mandanten Billing → Stripe / PayPal / Guthaben

Expired / Not subscribed

Inhaber verschiebt manuell das Ablaufdatum in Tenants → Bearbeiten

Subscribed bis zum neuen Ablaufdatum

Manuelles Überschreiben durch Inhaber (für Kulanzverlängerungen verwendet)

Wichtige Nuance bei der Kündigung: Ein Klick auf Cancel subscription entzieht den Zugriff nicht sofort. Es stoppt die nächste wiederkehrende Zahlung – Ihr Mandant behält den Zugriff bis zum Ende der zuletzt bezahlten Periode und wechselt erst zu Expired, nachdem diese Periode endet. Dasselbe gilt für eine vom Inhaber initiierte Kündigung. Für den vollständigen Kündigungsablauf siehe Mandanten kündigen und löschen.

Was in Booknetic SaaS gespeichert wird vs. was beim Anbieter liegt

Dies ist der wichtigste Abschnitt in diesem Dokument und der Abschnitt, den die meisten Inhaber nachdem sie einem Kunden bereits etwas versprochen haben, das Booknetic SaaS nicht liefern kann, lesen. Lesen Sie ihn, bevor die Kunden-E-Mail eintrifft, nicht danach.

Booknetic SaaS ist ein dünnes Spiegelbild des Status. Ihr Zahlungsanbieter – Stripe, PayPal oder WooCommerce – ist die einzige Quelle der Wahrheit für das Geld. Das hat praktische Folgen dafür, was Sie Ihren Mandanten zeigen können, was Sie exportieren können und was passiert, wenn etwas schiefläuft.

Hier die ehrliche Aufteilung.

Was Booknetic SaaS lokal auf Ihrer WordPress-Seite speichert

Für jeden Mandanten führt Booknetic SaaS einen kleinen Datensatz:

  • Auf welchem Tarif sie sind.
  • Wann ihr aktueller Zugang endet (das läuft ab in-Datum, das Sie auf der Billing-Seite des Mandanten sehen).
  • Ob sie ein aktives Abonnement bei Ihrem Zahlungsanbieter haben, und eine Referenz-ID für dieses Abonnement.
  • Ihr Guthaben, falls Sie die WooCommerce-Aufladefunktion aktiviert haben.
  • Ob sie ihre Anmelde-E-Mail verifiziert haben.

Und für jedes wichtige Abrechnungsevent fügt Booknetic SaaS eine Zeile zur Abrechnungshistorie dieses Mandanten hinzu:

  • Das Datum des Ereignisses.
  • Den Betrag.
  • Die verwendete Zahlungsmethode (Kreditkarte über Stripe, PayPal oder Guthaben).
  • Den Status (bezahlt, gekündigt, etc.).
  • Eine Kennung zur Querverweis mit Ihrem Zahlungsanbieter.

Das war's. Es reicht aus, um Ihre Admin-Ansichten zu betreiben, den Mandantenzugang zur richtigen Zeit zu steuern und ein durchscrollbares Protokoll zu führen. Es ist nicht ausreichend, um Ihr Buchhaltungssystem zu ersetzen.

Was bei Stripe liegt (wenn Ihr Mandant mit Stripe bezahlt)

Wenn ein Mandant Sie über Stripe Checkout zahlt, bleibt Stripe:

  • Der vollständige Abonnementeintrag (aktueller Zeitraum, nächstes Verlängerungsdatum, vollständige Geschichte).
  • Jede Rechnung – bezahlt, unbezahlt, ungültig, erstattet – als herunterladbares PDF.
  • Zahlungsabsichts-IDs und die zugrundeliegenden Kartendetails (in PCI Scoped – Booknetic SaaS sieht die Kartennummer nie).
  • Rückerstattungsunterlagen, einschließlich teilweisen Rückerstattungen und Streitverlauf.
  • Mahnwesen-Versuche (Stripe Smart Retries) und das Ergebnis jedes erneuten Versuchs.
  • Die E-Mail-Adresse des Mandanten bei Stripe, verwendet für die Zustellung der Quittung.

Alles, was ein PDF, ein Rückerstattungsdetail, eine Rückbuchung oder eine Aktualisierung der Karte auf der Datei benötigt, passiert in Ihrem Stripe Dashboard, nicht in Booknetic SaaS. Wir spiegeln genug vom Abonnementstatus nach, um zu wissen: "Ja, sie werden bis zu diesem Datum bezahlt" – wir spiegeln die finanziellen Details nicht wider.

Was lebt mit PayPal (wenn Ihr Mandant mit PayPal bezahlt)

PayPal speichert die Billing Vereinbarung – den Vertrag über wiederkehrende Zahlungen mit Ihrem Mandant – sowie alle Transaktionen unter dieser Vereinbarung:

  • Der Vertragsstaat (Aktiv, Suspendiert, Gekündigt).
  • Jeder PAYMENT.SALE (Verlängerungszahlung) Eintrag.
  • Die PayPal-Seite des Zahlers Details.
  • Rückerstattungsunterlagen auf PayPal Seite.

Wenn Sie in Booknetic SaaS auf Cancel subscription für einen per PayPal bezahlten Mandant klicken, bittet Booknetic PayPal, den Vertrag zu suspendieren (nicht zu kündigen). Das Abkommen bleibt PayPal und ist theoretisch von PayPal Seite aus wieder einsetzbar. Für das rechtliche Offboarding (vollständige Vertragskündigung) sollten Sie es über Ihr PayPal-Dashboard machen.

Was lebt mit WooCommerce (wenn Ihre Mandanten per Kaution auffüllen)

Wenn Sie die WooCommerce Einzahlungs-/Guthaben-Leiste aktiviert haben, befindet sich das Einzahlungsbuch in WooCommerce:

  • Jede WC-Anordnung, die die Kaution eines Mandanten finanziert hat (wobei die WC-Zahlungsmethode verwendet wird – Stripe-WC, Banküberweisung, COD, alles, was WC unterstützt).
  • Der WC-Kundeneintrag des Mandanten.
  • Die eigenen Rückerstattungsunterlagen von WC zu den Einzahlungsanweisungen.

Booknetic SaaS speichert nur den resultierenden Saldo bei jedem Mandanten. Wenn Sie eine WooCommerce Anzahlung in Ihrem WC-Administrator erstatten, zieht Booknetic SaaS nicht automatisch vom Guthaben des Mandanten ab – Sie müssen den Saldo manuell in Booknetic SaaS → Tenants → Bearbeitung anpassen.

Die einzige Regel, die das handhabbar hält

Wenn ein Kunde Sie nach irgendetwas fragt, das eine Nummer, ein PDF oder einen Rückerstattungsnachweis beinhaltet, lautet die Antwort in der Regel:

  1. Booknetic SaaS zeigt Ihnen den Status (abonniert / abgelaufen, Ablaufdatum, aktueller Tarif, verwendete Zahlungsmethode).
  2. Stripe / PayPal / WooCommerce zeigt Ihnen das Detail (das Rechnungs-PDF, den Rückerstattungsnachweis, den Streitfall, die Karte).

Inhaber, die Booknetic SaaS als ihr Buchhaltungsrückgrat betrachten, verbringen viel Zeit mit Phantomabstimmungsproblemen. Inhaber, die es als Spiegelbild des Anbieterstaates und Stripe / PayPal / WC als maßgebliches Hauptbuch behandeln, haben es viel leichter.

Wie findet man die Abrechnungshistorie eines Mandanten

Die Abrechnungshistorie auf der Inhaberseite befindet sich im SaaS-Admin, in der per-Mandant-Ansicht.

  1. Öffnen Sie WP Admin → Booknetic SaaS → Tenants.
  2. Finde die Mandantenzeile.
  3. Klicken Sie auf das Aktionsmenü der Zeile (das Drei-Punkte-Menü am Ende der Reihe) und wählen Sie Zahlungsverlauf.

Die Zahlungshistorie-Ansicht listet alle Abrechnungsereignisse für diesen Mandant auf – Zahlung erhalten, Abonnement gekündigt, guter Saldo eingezahlt. Jede Reihe zeigt:

  • Das Datum der Veranstaltung.
  • Der Betrag.
  • Der Tarif dazu.
  • Die Zahlungsmethode (Karte über Stripe, PayPal oder Kontostand).
  • Der Status der Veranstaltung.
  • Eine Referenzkennung, die Sie mit Ihrem Anbieter abgleichen können.

Aus der Sicht des Mandanten eigener erscheinen dieselben Informationen im eigenen Booknetic-Panel – sie öffnen Billing in ihrem Mandant-Admin und scrollen zum Billing History-Abschnitt unter dem Plankarten-Raster.

Was diese Ansicht nicht zeigt. Die Zahlungshistorie-Ansicht im SaaS-Admin zeigt nicht an: Rechnungs-PDFs, Rückerstattungsdetails, Wiederholungsversuchshistorie oder die Karte im Register. Für eines dieser Fälle öffnen Sie den entsprechenden Stripe / PayPal / WC-Datensatz mit der Referenzkennung aus der Zeile Booknetic.

Wo findet man das nächste Verlängerungsdatum eines Mandanten

Zwei Orte, mit derselben Antwort, aber unterschiedlicher Ergonomie.

Aus Sicht des Mandanten — Billing → Aktueller Tarif

Wenn der Mandant seinen Billing → aktuellen Tarif-Modal öffnet, zeigt das Ablaufdatum in das Datum an, an dem sein aktueller Zugriff endet. Für einen Mandanten mit einem wiederkehrenden Abo ist das auch das Datum, an dem die nächste Verlängerung läuft.

Aus Sicht des Inhabers – Tenants → Mandantenzeile

Die Tenants-Liste zeigt das Ablaufdatum jedes Mandanten in der Spalte Läuft ab an. Für einen Mandanten mit einem Stripe- oder PayPal-Abonnement ist das das Datum, an dem der Anbieter die nächste Verlängerungszahlung versucht.

Für die reichste Ansicht einer bevorstehenden Verlängerung – genauer Betrag, geplantes Wiederholungsverhalten falls die Karte fehlschlägt usw. – gehe zu Ihren Stripe Dashboard → Kunden → [der Mandant] → Abonnements oder PayPal → Aktivität → wiederkehrende Zahlungen. Stripe und PayPal haben ein viel detaillierteres Bild davon, "was als Nächstes passiert" als Booknetic SaaS.

Notiz zum Timing. Das Ablaufdatum in des Mandanten und der tatsächliche Zugriffsabbruch basieren auf der Zeitzone Ihr WordPress Servers. Bei den meisten Einrichtungen spielt das keine Rolle – die Verlängerung erfolgt im selben Moment, in dem der Zeitraum endet, und Ihr Mandant bemerkt es nicht. Wenn Sie präzise Zeitangaben über Zeitzonen hinweg benötigen (z. B. für internationale Kunden), bestätigen Sie Ihre WordPress Standort-Zeitzone in WP Admin → Settings → General → Timezone und testen Sie mit einem Sandbox-Mandanten.

Inhaber-Workflow: Sehen Sie sich diesen Monat alle zahlenden Mandanten an

In Booknetic SaaS gibt es keinen eingebauten Filter "Zahlende Mandant dieses Monats" – aber Sie können die Ansicht von zwei Bildschirmen aus zusammenstellen.

Von Booknetic SaaS

  1. Öffnen Sie WP Admin → Booknetic SaaS → Tenants.
  2. Filtern Sie die Liste nach Subscribed-Status.
  3. Sortiere nach der Spalte Läuft ab, um zu sehen, wer zur Verlängerung steht und wer eine kürzliche Verlängerung hat.

Das gibt Ihnen die Anzahl der Mandanten, die derzeit einen bezahlten Tarif haben. Es zeigt Ihnen nicht die Geldbeträge pro Mandant an – dafür können Sie in die Zahlungshistorie jedes Mandanten eingreifen.

Von Stripe / PayPal

Für die Umsatz-Ansicht im gleichen Zeitraum:

  • Stripe Dashboard → Zahlungen (oder Abonnements → Alle Abonnements nach Status Active gefiltert) — gibt Ihnen die Liste der aktiven Abonnements, aktuelle Periodensummen, MRR und Umsatztrends.
  • PayPal → Aktivität → Alle Transaktionen nach Datum und Art gefiltert (wiederkehrende Zahlung) — gibt Ihnen das Äquivalent für Ihre per PayPal bezahlten Mandanten.

Die Provider-Dashboards sind der Ort, an dem sich Ihre Buchhaltungsansicht tatsächlich befindet. Booknetic SaaS gibt Ihnen die Mandant-Ebene-Vereinigung ("dieser Mandant zahlt dich"); Der Anbieter gibt Ihnen die Gesamtsummen auf Transaktionsebene.

Inhaber-Workflow: Exportiere Abrechnungsdaten für die Buchhaltung

Booknetic SaaS enthält derzeit nicht einen nativen "Abrechnungshistorie exportieren"-Button auf den Tenants- oder Zahlungsverlaufsbildschirmen. Es gibt keinen integrierten CSV- oder Excel-Export aus dem SaaS-Admin.

Das ist die ehrliche Antwort. So bekommst Sie trotzdem Ihre Buchhaltungsdaten.

Option 1 — Exportieren von Ihrem Zahlungsanbieter

Das ist der empfohlene Weg, weil der Anbieter ohnehin die vollständige Akte hat.

  • Stripe: Öffnen Sie Stripe Dashboard → Zahlungen (oder Kunden, oder Abonnements), stellen Sie den Datumsbereich ein, oben rechts auf Export klicken und die CSV herunterladen. Der Stripe-Export umfasst Rechnungs-IDs, Kunden-E-Mails, Beträge in Ihrer Währung, Gebühren und Nettobeträge – alles, was Ihr Buchhalter tatsächlich benötigt.
  • PayPal: Öffnen Sie PayPal → Aktivität → Alle Transaktionen, legen Sie den Datumsbereich fest, klicken Sie auf Herunterladen und wählen Sie das CSV- oder PDF-Format.
  • WooCommerce (für Einzahlung/Aufladungsvolumen): WooCommerce hat einen eigenen Bestellungen → Export-Pfad, oder Sie können jede WooCommerce CSV-Exporterweiterung verwenden. Die WC-Anordnungen, die Mandanteneinzahlungen finanziert haben, werden mit der Booknetic Einzahlungslinie markiert.

Option 2 — Fügen Sie Booknetic SaaS Ihrem Anbieterdatensatz zu.

Wenn Sie speziell wissen müssen, zu welchem Mandant jede Provider-Transaktion gehört, verwenden Sie die Spalte Referenzkennung in Tenants → Mandant → Zahlungshistorie, um sie mit der Stripe subscription ID oder dem PayPal agreement_id in Ihrem Provider-Export abzugleichen. Das ist ein manueller Schritt, aber es ist der einzige Weg, die Mandant-Identität (in Booknetic SaaS) mit transaktionsbezogenen finanziellen Details (bei Ihrem Anbieter) zu verbinden.

Was wir nicht empfehlen

  • Das manuelle Scrapen der Zahlungshistorik-Ansicht des SaaS-Administrators in eine Tabelle – genau, aber langsam und Sie verpasst sowieso Rückerstattungsaufzeichnungen und Details zum Mahnwesen. Der Export von Anbietern ist schneller und vollständiger.
  • Alles zu bauen, was davon abhängt, dass Booknetic SaaS Ihre einzige Buchhaltungsquelle ist. Wie oben beschrieben, spiegelt Booknetic SaaS nur einen dünnen Schnitt des Statuses wider.

Ein Hinweis zum Produktfeedback. Ein integrierter CSV-Export der Mandantenabrechnungshistorie ist eine häufige Kundenanfrage. Wenn Sie dadurch entblockt werden, teilen Sie uns das über die üblichen Produktfeedback-Kanäle – das steht auf dem Radar des Teams.

Häufige Fragen

Wo kann ich sehen, wann die nächste Verlängerung meines Mandanten stattfindet? Das Ablaufdatum im Billing → aktuellen Tarif-Modal des Mandanten ist die zugänglichste Antwort für den Mandanten; die Spalte Läuft ab auf Ihrer Tenants-Liste ist für dich das Äquivalent. Für das anbieterseitige Bild (genaue Menge, Wiederholungsverhalten, Inflight-Mahnwesen) geh direkt zu Ihrem Stripe Dashboard- oder PayPal-Konto.

Kann ich die Abrechnungshistorie in CSV exportieren? Nicht direkt von Booknetic SaaS – es gibt keinen nativen CSV-Export-Button auf den Tenants- oder Zahlungsverlaufsbildschirmen. Der Standardweg besteht darin, aus dem Dashboard Ihres Zahlungsanbieters zu exportieren (Stripe Dashboard → Payments → Export oder PayPal Activity → Download) und im Booknetic SaaS mit der Referenzkennung des Mandanten abzugleichen, falls Sie Einnahmen bestimmten Mandanten zuordnen müssen.

Was passiert, wenn ich eine Rechnung in Stripe zurückerstatte – weiß Booknetic SaaS das? Nein. Booknetic SaaS aktualisiert nicht automatisch den Abonnementstatus eines Mandanten, wenn Sie eine Rückerstattung in Stripe (oder PayPal, oder WooCommerce) ausstellen. Der Mandant wird weiterhin als Subscribed mit demselben Ablaufdatum angezeigt, bis Sie es manuell anpassen. Wenn eine Rückerstattung Teil einer Kündigung ist, besteht die Standardlösung darin, Booknetic SaaS → Tenants → Bearbeiten beim Mandanten zu öffnen, dessen Ablaufdatum auf ein früheres Datum (typischerweise heute) zu setzen und zu speichern. Wenn die Rückerstattung teilweise erfolgt und Sie beabsichtigt haben, dass der Mandant einen Teil seines Zeitraums verliert – gilt dieselbe Änderung; Setzen Sie einfach das Datum, an dem der Zugang enden soll. Dies ist eine bekannte Lücke und ein Kandidat für ein zukünftiges Produktupdate; Behalten Sie vorerst die Gewohnheit bei, Rückerstattungsaktionen manuell zu spiegeln.

Warum zeigt mein Mandant in Booknetic SaaS "Subscribed" an, aber Stripe steht "past_due"? Weil Booknetic SaaS keinen eigenen "past_due" oder "Mahnwesen"-Zustand hat – er wechselt nur zu Expired, wenn Stripe vollständig aufgibt und customer.subscription.deleted entlässt (oder wenn die Periodengrenze ohne erfolgreiche Verlängerung vorbei ist). Während Stripe die Karte weiterhin mit Smart Retries erneut versucht, wird Booknetic SaaS den Mandanten weiterhin als abonniert anzeigen. Zwei Dinge, die Sie überprüfen sollten:

  1. Der Webhook ist gesund. Wenn Ihr Stripe-Webhook falsch konfiguriert ist (falsches Geheimnis, falsche URL, Signatur fehlschlägt), erfährt Booknetic SaaS nichts von der eventualen Kündigung, wenn Stripe aufgibt – und der Mandant bleibt für immer "abonniert", versehentlich. Überprüfen Sie Ihre Webhook-Einrichtung unter Einrichten des Stripe-Webhook. Das ist die mit Abstand häufigste Ursache für "Booknetic und Stripe uneinig".
  2. Ihr Anbieter ist die Wahrheit. Während Mahnwesen im Flug ist, liegt die Wahrheit in Stripe, nicht in Booknetic SaaS. Wenn Sie auf den Mahnwesen-Staat reagieren müssen – z. B. dem Mandanten selbst eine E-Mail mit der Nachricht "Karte fehlgeschlagen" senden – lesen Sie diese aus Ihrem Stripe Dashboard.

Kann ich Rückerstattungen in der Booknetic SaaS Abrechnungshistorie sehen? Nein — Rückerstattungen, die in Stripe, PayPal oder WooCommerce ausgegeben wurden, erscheinen nicht im Zahlungsverlauf-Ansicht in Booknetic SaaS. Das Booknetic-seitige Logbuch erfasst nur Zahlungen, Abonnement-gekündigte und einzahlungsgutgeschriebene Ereignisse. Für die Rückerstattungsübersicht nutzen Sie das Dashboard Ihres Anbieters.

Mein Mandant hat gekündigt – wann endet sein Zugang tatsächlich? Am Ende des zuletzt bezahlten Zeitraums, nicht sofort. Booknetic SaaS zeigt den Mandanten bis zum Ende seines bezahlten Zeitraums weiterhin als abonniert an und setzt ihn dann auf Expired, wenn die Frist abgelaufen ist. Dies gilt sowohl für vom Mandanten initiierte als auch vom Inhaber initiierte Kündigungen, sowohl auf Stripe als auch auf PayPal. Für den vollständigen Kündigungsablauf (und das Muster "zuerst abbrechen, dann verifizieren beim Anbieter" und dann optional löschen) siehe Kündigung und Löschen von Mandanten.

Was ist der Unterschied zwischen "Expired" und "Not subscribed"? Expired bedeutet, dass der Mandant ein Abonnement hatte (kostenlose Testphase, bezahlt oder mit gutem Saldo) und das Zugangsfenster abgelaufen ist. Not subscribed bedeutet, dass der Mandant seine E-Mail-Adresse überprüft hat, als Mandant existiert, aber nie ein Abonnement hatte – oder, seltener, eines hatte, das seinen Kündigungszyklus so weit abgeschlossen hat, dass selbst der bezahlte Zeitraum nach der Kündigung abgelaufen ist. Nach der Erfahrung des Mandanten sehen sich beide Status ähnlich: Er hat die abgelaufenen Tarifgrenzen von Booknetic SaaS erreicht und kann sich durch die Auswahl eines Tarifs auf der Billing Seite erholen.

Alles, was man wissen muss

Der Webhook ist der Synchronisationsmechanismus – halte ihn gesund

Fast jedes "Booknetic SaaS und mein Anbieter sind anderer Meinung"-Support-Ticket führt auf einen falsch konfigurierten Webhook zurück. Wenn Ihr Stripe-Webhook-Geheimnis leer, falsch oder auf den falschen Endpunkt zeigt, werden die Verlängerungen das Ablaufdatum des Mandanten stillschweigend nicht aktualisieren – obwohl Stripe die Karte gerne belastet. Gleiches gilt für PayPal: Wenn die paypal_webhook_id nicht konfiguriert ist, werden die PAYMENT.SALE.COMPLETED Ereignisse abgelehnt und Booknetic SaaS verlängert den Ablauf nie.

Wenn Ihre Mandanten zahlen, aber ihre Ablaufdatum nicht verlaufen, ist der Webhook der erste Ort, an dem Sie suchen sollten. Siehe Einrichten des Stripe-Webhook für die vollständige Einrichtungs- und Fehlerbehebungsanleitung.

Booknetic SaaS stimmt keine Rückerstattungen ab – Sie tun es

Das haben wir oben besprochen; Es lohnt sich, es zu wiederholen, weil es das häufigste Versöhnungsproblem ist. Eine Rückerstattung, die in Stripe, PayPal oder WooCommerce ausgestellt wird, wird nicht in Booknetic SaaS zurückverbreitet. Wenn eine Rückerstattung auch den Zugriff widerrufen sollte, müssen Sie diese Änderung in Tenants → Edit → Expires on spiegeln. Integrieren Sie das als Gewohnheit in Ihren Rückerstattungsprozess – Ihr zukünftiges Ich wird Ihnen dankbar sein.

Eine Kündigung beim Anbieter aktualisiert Booknetic SaaS nicht immer sofort

Wenn Sie ein Abonnement direkt über das Stripe- oder PayPal-Dashboard kündigen (statt über Booknetic SaaS), wird die Kündigung über den Webhook zurück zu Booknetic SaaS übertragen — früher oder später. Wenn der Webhook jedoch nicht korrekt eingerichtet ist, wird der Mandant weiterhin als Subscribed in Booknetic SaaS angezeigt, bis das ursprüngliche Expires on-Datum erreicht ist. Die Kündigung über Booknetic SaaS (Mandantenseite Billing → Cancel subscription oder Ihr Pendant auf der Inhaberseite) ist in der Regel der sauberere Weg, da dabei sowohl die Anbieter-Kündigung als auch die lokale Statusaktualisierung gleichzeitig ausgelöst werden.

Balance-finanzierte Mandanten verhalten sich etwas anders

Wenn ein Mandant über die WooCommerce-Einzahlungs-/Saldo-Schiene bezahlt, werden die Verlängerungen durch Abzug vom gespeicherten Guthaben finanziert, anstatt eine Karte zu belasten. Solange das Guthaben den Betrag für den nächsten Zyklus deckt, zieht Booknetic SaaS automatisch ab und verlängert das Endet am-Datum — ohne dass ein Anbieter-Webhook beteiligt ist. Die Abrechnungshistorie des Mandanten zeigt die Abbuchung auf die gleiche Weise, wie eine Stripe- oder PayPal-Zahlung angezeigt wird. Der Haken: Läuft das Guthaben ab, erfolgt die nächste „Verlängerung“ einfach nicht, und der Mandant wechselt an der nächsten Periodengrenze zu Expired. Es gibt kein automatisches Aufladen über eine Zahlungsmethode.

Manuell ausgestellte Stripe-Rechnungen verlängern den Zugriff nicht

Wenn Sie eine einmalige Rechnung direkt in Ihrem Stripe Dashboard ausstellen (zum Beispiel ein manuelles jährliches Upgrade oder eine Sonderaktionsrechnung), und der Mandant diese bezahlt, trifft der entsprechende Stripe-Webhook bei Booknetic SaaS ein — wird aber als manuelles Abrechnungsevent gekennzeichnet und verlängert nicht das Ablaufdatum des Mandanten. Um diese manuelle Rechnung in Booknetic SaaS zu berücksichtigen, müssen Sie das Endet am-Datum des Mandanten selbst in Tenants → Bearbeiten nach vorne setzen.

Nächste Schritte

  • Lesen Sie Trials in Booknetic SaaS, um das vollständige Bild darüber zu erhalten, wie ein Testmandant zu einem zahlenden Mandanten wird — das ist der wichtigste Übergang auf Ihrer Plattform.
  • Lesen Sie Plans und Planungskapazitäten, um die Tarife zu entwerfen, denen der Abonnementstatus tatsächlich zugeordnet ist — Fähigkeiten und Limits ändern sich, wenn ein Mandant zwischen den Zuständen wechselt.
  • Lesen Sie Kündigung und Löschung von Mandanten für die sichere Reihenfolge, um ein Abonnement zu kündigen, die Kündigung bei Ihrem Anbieter zu überprüfen und erst dann (falls erforderlich) den Mandanteneintrag zu löschen.
  • Lesen Sie Einrichten des Stripe-Webhooks — die Gesundheit des Webhooks ist der wichtigste Faktor dafür, ob Booknetic SaaS und Ihr Anbieter synchron bleiben.
  • Lesen Sie Stripe-Abrechnungen von Abonnements in Booknetic SaaS für die umfassendere Stripe-Abrechnungsreferenz einschließlich Mahnwesen, Rückerstattungen und der Grenze zwischen Test- und Live-Modus.

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