Emby-Zugang per Abo mit Stripe verkaufen: Tarife, Testphase, automatische Sperre

Wenn du einen Emby-Server für einen Club, einen gemeinsamen Haushalt oder eine kleine Community betreibst, kennst du das eigentliche Problem: Es ist nicht das Streaming, sondern die Buchhaltung. Jemand muss sich merken, wer bezahlt hat, an Verlängerungen erinnern und entscheiden, was passiert, wenn eine Karte abläuft. Cashier verlagert diese Arbeit zu Stripe und zu Emby selbst: Ein Besucher registriert sich, wählt einen Tarif, bezahlt, und das Konto wird aktiviert, sobald Stripe die Zahlung bestätigt. Schlägt eine Verlängerung fehl, wird das Konto gesperrt – nie gelöscht –, bis die Rechnung bezahlt ist. Das ist das Emby-Abo mit Stripe in der Praxis.

Diese Anleitung führt durch die Einrichtung, so wie ich sie auf meinem eigenen Server gemacht habe – mit den Einstellungen, auf die es wirklich ankommt, und den Stolperfallen, in die ich getappt bin. Sie geht davon aus, dass du für legale, selbst gehostete Medien Geld verlangst – mehr dazu unten.

Bevor du loslegst

Inhaltsrechte. Cashier rechnet deine Nutzer über dein eigenes Stripe-Konto ab. Du allein bist dafür verantwortlich, die Rechte an den Inhalten oder Diensten zu besitzen, für die du Geld verlangst – die Filme, Serien oder Kanäle auf deinem Server. MediaLab Works stellt nur die Software bereit und ist nicht Partei deiner Verkäufe. Stripe kann ein Konto schließen oder einschränken, das für Inhalte ohne Rechte Geld verlangt; siehe Stripes Liste restricted businesses. Halte deine Bibliothek auf Inhalte beschränkt, die dir gehören oder für die du lizenziert bist.

Voraussetzungen:

• Emby Server 4.10.1 oder neuer (Linux, Windows oder Docker).
• Das Registration-Plugin 1.10 oder neuer, installiert und lizenziert. Cashier nutzt dessen Registrierungsseite, dessen E-Mail-Einstellungen und dessen Konten; ohne es zeigt Cashier den Grund auf seiner Seite an.
• Ein Stripe-Konto (kostenlos zu eröffnen; Stripe berechnet seine eigene Gebühr pro Zahlung) und dein Server über HTTPS erreichbar, für die Kundenseite und den Stripe-Webhook.
• Eine MediaLab-Works-Lizenz für Cashier: ein aktives Abo, eine Lifetime-Lizenz innerhalb ihres Update-Zeitraums oder die kostenlose 30-Tage-Testversion.

Schritt 1 — Plugin installieren

1. Melde dich in deinem MediaLab-Works-Konto an, öffne Licenses und lade die Plugin-DLL herunter.
2. Kopiere sie in den Emby-Plugin-Ordner und starte Emby Server neu:
   • Linux (Paket): /var/lib/emby/plugins/
   • Docker: der plugins-Ordner im Emby-Konfigurationsvolume
   • Windows: %AppData%\Emby-Server\programdata\plugins\
3. Öffne Cashier im Emby-Dashboard-Menü, klicke auf Open License page, füge deinen Lizenzschlüssel ein und aktiviere ihn – oder gib deine E-Mail ein, um die Testversion zu starten oder eine Lizenz zu kaufen. Das Plugin bindet den Schlüssel an diesen Server und zeigt die Lizenz als Active.

Die Lizenz wird einmal täglich und bei jedem Emby-Start geprüft. Ohne Internet funktioniert das Plugin nach der letzten erfolgreichen Prüfung noch 7 Tage weiter, danach nicht mehr, bis es wieder prüfen kann. Falls du jemals zurück willst: Dieselbe Seite kann ein Update installieren oder auf die vorherige Version zurückrollen; starte Emby danach neu.

Schritt 2 — Zuerst Registration einrichten

Cashier stützt sich für die Registrierungsseite, die Konten und den E-Mail-Server auf Registration. Stelle in Registration die öffentliche Adresse und den E-Mail-Server ein, bevor du Cashier anfasst – sonst haben Kunden-E-Mails kein Ziel. Öffne dann Cashier: Oben auf der Seite siehst du, ob Stripe und Registration verbunden sind.

Schritt 3 — Stripe verbinden

Im Tab Stripe:

1. Gehe in Stripe zu Developers → API keys und erstelle einen eingeschränkten Schlüssel mit Schreibzugriff auf Products, Prices, Checkout Sessions, Customer portal, Customers, Subscriptions und Webhook Endpoints sowie Lesezugriff auf Events und Invoices. Der normale Secret Key funktioniert ebenfalls.
2. Füge ihn ein und klicke auf Save and test.

Beginne mit einem Testschlüssel (sk_test_… / rk_test_…) und der Karte 4242 4242 4242 4242. Bring den ganzen Ablauf im Testmodus zum Laufen, bevor ein echter Kunde die Seite sieht.

Schritt 4 — Einstellungen: Dienstname und öffentliche Adresse

Im Tab Settings legst du den Dienstnamen fest, der Kunden und in Stripe angezeigt wird, und die öffentliche Serveradresse (zum Beispiel https://emby.example.com). Diese Adresse wird für die Rückkehr von Stripe, die Zahlungslinks und den Webhook verwendet.

Gehe dann zurück zu Stripe und klicke auf Create the webhook automatically. Ohne öffentliche Adresse funktioniert Cashier trotzdem – es liest die Events alle paar Minuten aus Stripe –, aber mit Webhook fühlt sich die Aktivierung sofort an.

Schritt 5 — Tarife festlegen

Im Tab Plans prüfst du jeden Tarif: monatlich oder jährlich, die Anzahl gleichzeitiger Streams (standardmäßig 1 bis 4) und der Preis. Ein Tarif für 2 Geräte erlaubt dem Konto die Wiedergabe auf zwei Bildschirmen gleichzeitig. Lege außerdem die Währung, die kostenlosen Testtage für das erste Abo, die Kulanzfrist nach einer fehlgeschlagenen Zahlung (standardmäßig 3 Tage) und optional Aktionscodes, Rechnungsadresse und Stripe Tax fest.

Klicke auf Save and push to Stripe: Das Produkt und die Preise werden in deinem Stripe-Konto angelegt. Zwei Verhaltensweisen solltest du kennen:

• Ein geänderter Preis erzeugt einen neuen Stripe-Preis; bestehende Abonnenten behalten ihren, bis sie den Tarif wechseln.
• Ein deaktivierter Tarif wird nicht mehr angeboten.

Schritt 6 — E-Mails und der Verkaufsschalter

Ebenfalls unter Settings wählst du aus, welche E-Mails an Kunden gehen – Erinnerung vor der nächsten Rechnung (und wie viele Tage vorher), fehlgeschlagene Zahlung, Beleg, Sperrung, wiederhergestellter Zugang – sowie deine eigenen Benachrichtigungen (jede Zahlung, fehlgeschlagene Zahlungen). Entscheide, ob die Wiedergabe über das Tariflimit hinaus gestoppt wird. Schalte dann Selling is on ein.

Die Kundenseite liegt unter /emby/Cashier/Page auf deiner Emby-Adresse, und neue Konten aus Registration werden automatisch dorthin geleitet.

Schritt 7 — Den ganzen Zyklus testen

Mit dem Testschlüssel:

1. Registriere dich über Registration, wähle einen Tarif und bezahle mit der Testkarte. Das Konto sollte mit dem Stream-Limit des Tarifs aktiviert sein.
2. Öffne die Kundenseite: Tarife, aktuelles Abo, nächste Zahlung und eine Schaltfläche Manage subscription, die das Stripe-Kundenportal öffnet (Karte, Rechnungen, Tarifwechsel, Kündigung).
3. Lass eine Testzahlung fehlschlagen und beobachte Kulanzfrist, E-Mails und Sperrung; bezahle dann die Rechnung und prüfe, ob das Konto zurückkommt.

Wie die Zahlung die Freigabe ersetzt

Ein über Registration erstelltes Konto bleibt deaktiviert, bis Stripe die Zahlung bestätigt; dann wird es mit dem Stream-Limit des Tarifs aktiviert. Das ist das ganze Modell: Die Zahlung ist die Freigabe. Ausbleibende Zahlung sperrt, löscht nie – nach einer fehlgeschlagenen Zahlung bleibt das Konto während der Kulanzfrist aktiv, während Stripe es erneut versucht, danach wird es deaktiviert; wird die Rechnung bezahlt, ist es wieder aktiviert. Das Löschen lange gesperrter Konten ist optional und standardmäßig aus.

Ein gesperrtes Konto kann sich nicht anmelden und bekommt deshalb einen signierten Zahlungslink, der 7 Tage gültig ist – per E-Mail oder von dir. Auf einem TV zeigt die Kundenseite einen QR-Code, damit der Kunde vom Handy aus bezahlt und der TV von selbst weiterläuft.

Admin-Tabs

Alles liegt im Emby-Dashboard: Subscribers (Zugang, Tarif, Verlängerungsdatum; Zahlungslink kopieren oder per E-Mail senden, von der Zahlung befreien, sperren, reaktivieren, entfernen, in Stripe öffnen), Payments (letzte Rechnungen und Ergebnis), Plans, Stripe, Settings und Log (jede Zustandsänderung). Require payment from an existing account fügt ein Konto hinzu, das du früher erstellt hast; es bleibt gesperrt, bis es bezahlt. Administratorkonten werden nie angefasst, und wenn du den Verkauf ausschaltest, bleiben alle Konten unverändert.

Tipps und Fehlerbehebung

• „Registration: missing, too old or stopped“ — installiere oder aktualisiere Registration auf 1.10 oder neuer, prüfe die Lizenz, starte Emby neu.
• Zahlungen aktivieren Konten nicht schnell — der Webhook erreicht den Server nicht. Prüfe, ob die öffentliche Adresse aus dem Internet über HTTPS erreichbar ist. Cashier gleicht alle 15 Minuten mit Stripe ab; Check Stripe now unter Subscribers erledigt das sofort.
• Keine E-Mails an Kunden — prüfe die E-Mail-Server-Einstellungen in Registration.
• „Selling is off or not configured“ — der Schlüssel fehlt, die Tarife wurden nicht zu Stripe gepusht, oder der Schalter in Settings ist aus.
• Wiedergabe über dem Limit wird auf Emby Web 4.10 nicht gestoppt — der Befehl „Stop“ wird dort ignoriert; der eigentliche Schutz ist das native Limit gleichzeitiger Streams. Plan Guard übernimmt die Überwachung, falls installiert.
• Lizenz läuft ab — Cashier stoppt: keine neuen bezahlten Registrierungen und keine Kontenänderungen, aber nichts wird gelöscht. Stripe-Events aus der Zwischenzeit werden gelesen, sobald die Lizenz wieder gültig ist.

Fazit

Cashier hält den langweiligen Teil eines Club-Servers langweilig: Tarife nach gleichzeitigen Streams, Stripe Checkout auf Stripes eigenen Seiten, sodass Kartendaten nie deinen Server erreichen, Zahlung, die aktiviert, und ausbleibende Zahlung, die sperrt. Richte es zuerst im Testmodus ein, halte deine Inhaltsrechte in Ordnung, und Verlängerungen erledigen sich weitgehend von selbst. Die vollständige Referenz findest du im user guide; für alles andere siehe die knowledge base, die FAQ oder kontaktiere uns.