Cashier für Emby — Einrichtungsanleitung

Installation

Du brauchst Emby Server 4.10.1 oder neuer und Registration 1.10 oder neuer, installiert und lizenziert.

Melde dich in deinem MediaLab-Works-Konto an, öffne Licenses und lade die Plugin-DLL herunter (verfügbar bei einem aktiven Abonnement, einer Lifetime-Lizenz innerhalb ihres Update-Zeitraums oder während des kostenlosen 30-tägigen Testzeitraums).
Kopiere die DLL in den Emby-Plugins-Ordner und starte Emby Server neu:
- Linux (Paket): /var/lib/emby/plugins/
- Docker: der Ordner plugins in deinem Emby-Konfigurations-Volume
- Windows: %AppData%\Emby-Server\programdata\plugins\
Öffne Cashier im Emby-Dashboard-Menü und klicke auf Open License page. Füge deinen Lizenzschlüssel ein und aktiviere ihn, oder gib deine E-Mail-Adresse ein, um den kostenlosen 30-tägigen Testzeitraum zu starten oder eine Lizenz zu kaufen. Das Plugin kontaktiert den Lizenzserver, bindet den Schlüssel an diesen Emby-Server und zeigt die Lizenz als Active an.

Die Lizenz wird einmal täglich (und bei jedem Start von Emby) geprüft. Ohne Internet läuft das Plugin nach der letzten erfolgreichen Prüfung noch 7 Tage weiter; danach wird es gestoppt, bis es wieder prüfen kann.

Lizenz

Ohne gültige Lizenz wird Cashier gestoppt: Die Kundenseite meldet, dass Abonnements nicht verfügbar sind, keine neuen kostenpflichtigen Anmeldungen werden akzeptiert und kein Konto geändert; nur die Seite License funktioniert weiter (dort kannst du den Test starten, kaufen, den Schlüssel eingeben oder aktualisieren). Abonnenten, Tarife und Einstellungen bleiben erhalten. Nichts wird gelöscht: Sobald die Lizenz wieder gültig ist, läuft alles weiter, und die Stripe-Ereignisse aus der Zwischenzeit werden dann gelesen.

Mit gültiger Lizenz kann dieselbe Seite ein Update installieren oder bei Problemen ein Rollback auf die vorherige Version ausführen. Starte Emby danach in beiden Fällen neu.

Konfiguration

Richte zuerst Registration ein: seine öffentliche Adresse und, für die E-Mails an Kunden, seinen E-Mail-Server. Öffne dann Cashier im Emby-Dashboard. Die Seite hat sechs Registerkarten: Subscribers, Payments, Plans, Stripe, Settings und Log; oben auf der Seite siehst du, ob Stripe und Registration verbunden sind.

Stripe: Erstelle in Stripe (Developers → API keys) 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 auch). Füge ihn ein und klicke auf Save and test. Teste zuerst mit einem Testschlüssel (sk_test_… / rk_test_…) und der Karte 4242 4242 4242 4242.
Settings: der Dienstname, der Kunden und in Stripe angezeigt wird, und die öffentliche Serveradresse (zum Beispiel https://emby.example.com), die für die Rückkehr von Stripe, die Bezahllinks und den Webhook verwendet wird. Klicke dann in Stripe auf Create the webhook automatically. Ohne öffentliche Adresse funktioniert Cashier weiterhin, indem es die Ereignisse alle paar Minuten von Stripe liest.
Plans: Prüfe jeden Tarif (monatlich oder jährlich, Anzahl gleichzeitiger Streams, Preis), die Währung, die Testtage, die Kulanztage nach einer fehlgeschlagenen Zahlung und die optionalen Promotion-Codes, Rechnungsadresse und Stripe Tax. Klicke auf Save and push to Stripe: Das Produkt und die Preise werden in deinem Stripe-Konto erstellt. Ein geänderter Preis erstellt einen neuen Stripe-Preis; bestehende Abonnenten behalten ihren, bis sie den Tarif wechseln, und ein deaktivierter Tarif wird nicht mehr angeboten.
Settings: Wähle die E-Mails an Kunden (Erinnerung vor der nächsten Rechnung und wie viele Tage vorher, fehlgeschlagene Zahlung, Zahlungsbeleg, Sperrung, Zugang wiederhergestellt), deine eigenen Benachrichtigungen (jede Zahlung, fehlgeschlagene Zahlungen) und ob Wiedergabe über dem Tarif-Limit gestoppt wird. Aktiviere dann Selling is on.

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

Tägliche Nutzung

Neue Kunden melden sich bei Registration an, wählen einen Tarif und zahlen; ihr Konto wird aktiviert, sobald Stripe die Zahlung bestätigt. Kunden ändern Karte, Tarif oder kündigen über Manage subscription auf der Kundenseite.
Subscribers listet jedes Konto mit Zugang, Tarif und Verlängerungsdatum. Aus der Zeile heraus kannst du den Bezahllink kopieren oder per E-Mail senden (7 Tage gültig), das Konto vom Bezahlen befreien, sperren oder reaktivieren, es aus Cashier entfernen oder in Stripe öffnen. Require payment from an existing account fügt ein Konto hinzu, das du zuvor erstellt hast; es bleibt gesperrt, bis es bezahlt.
Payments zeigt die neuesten Rechnungen und ihr Ergebnis; Log zeigt jede Zustandsänderung.
Das Verkaufen auszuschalten lässt jedes Konto unverändert. Cashier bearbeitet nur die Konten in seiner Liste, niemals Administratoren.

Fehlersuche

Registration: fehlt, zu alt oder gestoppt: Installiere Registration in Version 1.10 oder neuer oder aktualisiere es, prüfe seine Lizenz und starte Emby dann 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 mit Stripe trotzdem alle 15 Minuten ab (Check Stripe now unter Subscribers tut es 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 übertragen oder der Schalter in Settings ist aus.

Inhaltsrechte

Cashier berechnet deine Nutzer über dein eigenes Stripe-Konto. Allein du bist dafür verantwortlich, die Rechte an dem Inhalt oder der Dienstleistung zu besitzen, für die du Geld verlangst (zum Beispiel 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 sperren oder einschränken, das Inhalte ohne die nötigen Rechte berechnet — siehe die Liste der eingeschränkten Geschäftsbereiche von Stripe.