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. Ghost selbst kennt für Stufen nur Stripe; mit Rechnungskit verkaufst du dieselben Stufen über deinen Checkout mit deutscher E-Rechnung, DATEV-Export und allen Zahlarten, die dein Checkout anbietet.

Einrichtung

1. Erstelle in Ghost unter Settings, Integrations eine Custom Integration und kopiere den Admin API Key (Format id:secret).
2. Öffne in Rechnungskit Einstellungen, dann 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.

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.

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. Eine Newsletter-Anmeldung ist rechtlich eine Werbe-Einwilligung (§ 7 UWG), die der Kauf allein nicht ersetzt. 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.

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.