Ghost verbinden (Mitgliedschaft automatisch)

Mit der Ghost-Integration macht Rechnungskit Käufer nach der Zahlung automatisch zu Mitgliedern deiner Ghost-Publikation und gibt ihnen die passende Stufe (Tier). Das funktioniert für Einmalkäufe über den Rechnungskit Checkout und für Abonnements, mit Ghost(Pro) genauso wie mit einer selbst gehosteten Installation. In Ghost selbst laufen bezahlte Stufen nur über Stripe. Mit Rechnungskit verkaufst du dieselben Stufen über deinen Checkout, mit deutscher E-Rechnung, DATEV-Export und allen Zahlarten, die dein Checkout anbietet. Ein Stripe-Konto brauchst du in Ghost dafür nicht.

Einrichtung

1. Lege in Ghost unter Settings, Integrations eine Custom Integration an, zum Beispiel mit dem Namen „Rechnungskit“. Ghost zeigt dir danach den Admin API Key im Format id:secret. Den kopierst du, den Content API Key brauchst du nicht.

   

2. Öffne in Rechnungskit Verbindungen → Integrationen und trage bei Ghost die Adresse deiner Publikation und den Admin API Key ein. Rechnungskit prüft die Verbindung sofort und lädt deine bezahlten Stufen. Läuft dein Ghost-Admin unter einer eigenen Domain, trage diese Admin-Adresse ein. Die Adresse muss per https erreichbar sein; lokale oder interne Adressen nimmt Rechnungskit nicht an.

   

3. Ordne deine Produkte den Ghost-Stufen zu. Einmalkauf und Abo sind beide möglich. Was eine Stufe freischaltet (Beiträge, Newsletter, Bereiche), legst du in Ghost fest.

   

4. Stell in Ghost bei jedem bezahlten Beitrag unter Post settings, Post access die Sichtbarkeit „Specific tier(s)“ ein und wähle die Stufe aus. Warum das sicherer ist als „Paid-members only“, steht unten bei Ghost ohne Stripe.

   

Stufe anlegen, wenn Ghost sie nicht anzeigt

Ohne Stripe blendet Ghost die Verwaltung der Stufen in seinen Einstellungen aus. Dort steht dann nur die kostenlose Stufe und der Knopf „Connect with Stripe“.

Eine bezahlte Stufe gibt es trotzdem: Ghost legt bei der Einrichtung eine an, sie trägt den Namen deiner Publikation und erscheint in Rechnungskit in der Zuordnung. Weitere Stufen legst du direkt in Rechnungskit an. Unter der Zuordnung öffnest du „Neue Stufe in Ghost anlegen“, gibst Name und Monatspreis ein und klickst auf „Stufe anlegen“. Rechnungskit legt die Stufe über die Admin-API an und wählt sie gleich in der Zuordnung vor.

Die neue Stufe ist im Ghost-Portal verborgen, weil du sie über deinen Checkout verkaufst. Der Preis ist in Ghost nur Anzeige. Bezahlt wird, was das zugeordnete Produkt in deinem Checkout kostet.

Zahlungslink im Beitrag

Ghost zeigt Lesern ohne Zugang unter einem gesperrten Beitrag seinen eigenen Hinweis mit „Subscribe now“. Dieser Knopf führt ins Ghost-Portal, das ohne Stripe nichts verkaufen kann. Setz deshalb in den frei lesbaren Teil des Beitrags, also über die Trennlinie zum Mitgliederbereich, einen Button-Block mit dem Zahlungslink deines Produkts. Den Link kopierst du in Rechnungskit unter Produkte beim jeweiligen Produkt: beim Einmalkauf mit „Link kopieren“, beim Abo mit „Abo-Link kopieren“ am Plan.

Nach der Zahlung meldet sich der Käufer mit dem Login-Link aus Ghosts Anmelde-E-Mail an und liest den ganzen Beitrag.

Was automatisch passiert

• Bei einer bezahlten Bestellung eines zugeordneten Produkts erhält der Käufer die Stufe. Ist er in Ghost noch kein Mitglied, legt Rechnungskit das Mitglied an (mit Namen, dem Label „Rechnungskit“ und der Bestellnummer als Notiz). Ghost verschickt dann seine Anmelde-E-Mail mit Login-Link; diese Option kannst du auf der Integrations-Seite abschalten.

  

• Die Stufe wird in Ghost als kostenfreie Mitgliedschaft (comped) ohne Ablaufdatum gesetzt. Ein Einmalkauf ist damit ein dauerhafter Zugang; bei einem Abo entscheidet Rechnungskit über Start und Ende.

• Bei einem Abo gilt: Die Stufe startet mit dem Abo, bleibt während Zahlungserinnerungen bestehen und wird erst entfernt, wenn das Abo wirklich endet (Kündigung zum Periodenende, Widerruf oder gescheiterte Zahlung nach allen Erinnerungen). Zahlt der Käufer danach wieder, wird die Stufe automatisch neu gesetzt.

• Bei einer vollen Erstattung eines Einmalkaufs wird die Stufe entfernt; das Mitglied bleibt als kostenloses Mitglied bestehen. Eine Teil-Erstattung lässt die Stufe bestehen.

• Rechnungskit entfernt nur die Stufe, die es selbst vergeben hat. Hat das Mitglied inzwischen eine andere Stufe, passiert nichts.

• Möchtest du nie automatisch entziehen, schalte die Option zum automatischen Entziehen in den Integrations-Einstellungen aus.

• Testkäufe und Test-Abos aus dem Testmodus vergeben die Stufe wie echte Käufe. Beim Go-live entfernt Rechnungskit diese Stufen wieder, so wie nach einer vollen Erstattung.

Das automatische Entfernen bei Erstattungen gilt für alle Zahlungsanbieter des Checkouts: Stripe, Mollie, PayPal und Unzer. Rechnungskit erkennt die volle Erstattung über die Rückmeldung des Zahlungsanbieters.

Newsletter

Neue Mitglieder werden standardmäßig nicht in deine Newsletter eingetragen. Werbung per E-Mail braucht grundsätzlich eine vorherige ausdrückliche Einwilligung (§ 7 Abs. 2 Nr. 2 UWG), und der Kauf allein ersetzt sie nicht. Die Ausnahme für Bestandskunden greift nur unter engen Voraussetzungen, unter anderem einem Hinweis auf das Widerspruchsrecht schon bei der Erhebung der Adresse (§ 7 Abs. 3 UWG). Wenn du die Einwilligung an anderer Stelle einholst, kannst du die Option „Neue Mitglieder in die Standard-Newsletter eintragen“ auf der Integrations-Seite einschalten. Bestehende Mitglieder bleiben in jedem Fall unverändert.

Ghost ohne Stripe

Die Integration braucht in Ghost keine Stripe-Verbindung. Ob ein Leser einen Beitrag sieht, entscheidet Ghost allein über Status und Stufe des Mitglieds. Neue Käufer werden mit der Stufe angelegt und können sofort lesen.

Eine Einschränkung gibt es. Ohne Stripe ändert Ghost bei bestehenden Mitgliedern nur die Stufe, nicht den Status: Kauft ein bisher kostenloses Mitglied, bleibt es in Ghost „free“, und endet sein Abo, bleibt es „comped“. Bei „Specific tier(s)“ spielt das keine Rolle, weil dort nur die Stufe zählt. Bei „Paid-members only“ entscheidet der Status. Stell bezahlte Beiträge deshalb auf „Specific tier(s)“.

Nach jeder Änderung prüft Rechnungskit, was Ghost tatsächlich übernommen hat. Fehlt nur der Status, steht die Aktion mit Hinweis im Protokoll, und die Integrations-Seite zeigt einen Hinweis zu Ghost ohne Stripe. Fehlt die Stufe, bekommst du eine offene Aufgabe.

Grenzen und Fehler

• Ein Mitglied kann in Ghost nur eine kostenfreie Stufe gleichzeitig tragen. Kauft dasselbe Mitglied ein zweites zugeordnetes Produkt, ersetzt die neue Stufe die alte.
• Hat ein Mitglied in Ghost bereits ein bezahltes Stripe-Abo, lehnt Ghost eine zusätzliche Stufe ab. Rechnungskit legt dann eine offene Aufgabe an, damit du den Fall in Ghost klären kannst.
• Die Identität im Drittsystem ist die E-Mail-Adresse des Käufers. Ändert ein Mitglied seine E-Mail in Ghost, findet Rechnungskit es beim Entziehen nicht mehr und lässt die Stufe unverändert.
• Jede Freischaltung und Sperrung erscheint im Protokoll auf der Integrations-Seite. Schlägt eine Aktion dauerhaft fehl (zum Beispiel nach einer Schlüssel-Rotation in Ghost), bekommst du eine offene Aufgabe und kannst die Aktion nach der Korrektur mit einem Klick wiederholen. Ist die Gegenseite vorübergehend nicht erreichbar, wiederholt Rechnungskit die Aktion etwa eine Stunde lang automatisch in wachsenden Abständen; bestehende Zugänge bleiben davon unberührt, denn Rechnungskit entzieht nie etwas wegen eines Fehlers.