Cashier — kostenpflichtige Emby-Abonnements

Cashier macht aus deinem Emby-Server einen kostenpflichtigen Dienst. Ein Besucher meldet sich an, wählt einen Tarif, zahlt über Stripe, und das Emby-Konto wird aktiv, sobald die Zahlung bestätigt ist; wird eine Verlängerung nicht bezahlt, wird das Konto gesperrt, bis die Rechnung bezahlt ist. Es arbeitet mit Registration zusammen, das die Anmeldeseite bereitstellt und die Konten erstellt.

Was es macht

• Tarife, die du festlegst, monatlich und jährlich, nach der Anzahl gleichzeitiger Streams (standardmäßig 1 bis 4), jeder mit eigenem Preis, plus optional ein kostenloser Testzeitraum für das erste Abonnement. Die Tarife werden als Preise in deinem Stripe-Konto angelegt; ein geänderter Preis erstellt einen neuen, und bestehende Abonnenten behalten ihren, bis sie den Tarif wechseln.
• Zahlungen über dein eigenes Stripe-Konto: Kunden zahlen auf Stripes gehosteter Checkout-Seite (Karte, Apple Pay / Google Pay und die Methoden, die Stripe anbietet), sodass Kartendaten nie deinen Server berühren. Optionale Promotion-Codes, Rechnungsadresse und Stripe Tax.
• Zahlung ersetzt die Freigabe: Ein über Registration erstelltes Konto bleibt deaktiviert, bis Stripe die Zahlung bestätigt, und wird dann mit dem Stream-Limit des Tarifs aktiviert. Besucher werden direkt nach der Anmeldung zur Tarifseite geschickt.
• Nichtbezahlung sperrt, löscht aber nie: Nach einer fehlgeschlagenen Zahlung bleibt das Konto für eine Kulanzfrist (standardmäßig 3 Tage) aktiv, während Stripe erneut versucht, dann wird es deaktiviert; die Bezahlung der Rechnung aktiviert es erneut. Das Löschen lange gesperrter Konten ist optional und standardmäßig aus.
• Schutz des Stream-Limits: Das Limit des Tarifs wird in der Emby-Benutzerrichtlinie gesetzt, und Wiedergabe darüber hinaus wird mit einer Meldung gestoppt (abschaltbar).
• Kundenseite auf deiner Emby-Adresse: Tarife, das aktuelle Abonnement, die nächste Zahlung und eine Schaltfläche Manage subscription, die das Stripe-Kundenportal öffnet (Karte, Rechnungen, Tarifwechsel, Kündigung). Ein gesperrtes Konto, das sich nicht anmelden kann, erhält einen signierten Bezahllink, gültig für 7 Tage, per E-Mail oder von dir. Auf einem Fernseher zeigt die Seite einen QR-Code, damit der Kunde vom Handy bezahlt und der Fernseher von allein weiterläuft.
• E-Mails an Abonnenten, jede mit eigenem Schalter: Erinnerung vor der nächsten Rechnung, Zahlungsbeleg, fehlgeschlagene Zahlung, Sperrung mit dem Bezahllink und wiederhergestellter Zugang. Sie gehen über den in Registration konfigurierten E-Mail-Server, in der Sprache, die der Kunde bei der Anmeldung gewählt hat.
• Verwaltung im Emby-Dashboard, mit Registerkarten für Subscribers, Payments, Plans, Stripe, Settings und Log: Sperren, Reaktivieren, vom Bezahlen befreien, den Bezahllink kopieren oder per E-Mail senden oder ein vorhandenes Konto zur Zahlung auffordern. Administratorkonten werden nie berührt.
• Zuverlässiger Zustand: Stripe-Ereignisse werden per Signatur geprüft und genau einmal angewendet; Cashier liest die Ereignisse außerdem alle 15 Minuten von Stripe, sodass ein verpasster Webhook kein Konto im falschen Zustand lässt.

Voraussetzungen

• Emby Server 4.10.1 oder neuer (Linux, Windows oder Docker).
• Registration 1.10 oder neuer, installiert und lizenziert. Cashier nutzt dessen Anmeldeseite, dessen E-Mail-Einstellungen und dessen Konten; ohne Registration zeigt Cashier den Grund auf seiner Seite an.
• Ein Stripe-Konto (kostenlos eröffnbar; Stripe berechnet seine eigene Gebühr pro Zahlung) und der Server über HTTPS erreichbar, für die Kundenseite und den Stripe-Webhook.

Häufige Fragen

Kann ich für den Zugang zu meinem Emby-Server Geld verlangen? Ja: Registration stellt die Anmeldeseite bereit, Cashier das Abonnement. Besucher wählen einen Tarif, zahlen über dein Stripe-Konto und ihr Konto wird sofort aktiviert; eine unbezahlte Verlängerung sperrt es. Siehe die Anleitung.

Was bedeutet „Device“ in einem Tarif? Ein gleichzeitiger Stream: Ein Tarif für 2 Geräte lässt das Konto auf zwei Bildschirmen gleichzeitig spielen.

Was passiert mit bestehenden Abonnenten ohne gültige Cashier-Lizenz? Cashier stoppt: keine neuen kostenpflichtigen Anmeldungen und keine Kontoänderungen. Nichts wird gelöscht; die Stripe-Ereignisse werden aufgeholt, sobald die Lizenz wieder gültig ist.

Was es wohin sendet

• Stripe (api.stripe.com, mit dem Secret- / eingeschränkten Schlüssel von deinem eigenen Stripe-Konto) — der einzige Zahlungsanbieter:
  • Stripe-Checkout-Sitzung (Seite bei Stripe gehostet; Abonnement): der Tarifpreis, Rückkehr-URLs zu deinem Server, die Emby-Benutzer-ID, die Server-ID und der Benutzername (Metadaten), die E-Mail-Adresse des Kunden (aus Cashier oder der Anmeldung) oder die vorhandene Stripe-Kunden-ID, die Sprache; optional: Testzeitraum, Promotion-Codes, Rechnungsadresse und automatische Steuer (standardmäßig aus).
  • Das Erstellen des Produkts und der Preise (Dienstname, Betrag, Währung, Intervall, Geräteanzahl), die Konfiguration des Stripe-Kundenportals (Karte/Tarif ändern, Rechnungen, kündigen).
  • Der Stripe-Webhook an deinen Server — nur, wenn du „create webhook automatically“ anklickst (braucht eine öffentliche HTTPS-Adresse); sonst liest der Server die Stripe-Ereignisse alle 15 Minuten (kein offener Port nötig).
  • Das Kündigen des Stripe-Abonnements, wenn du einen Nutzer mit aktivem Abonnement löschst.
  • Kartendaten erreichen nie deinen Server: Zahlungsdetails werden nur auf den Seiten von Stripe eingegeben.
• Eingehender Webhook (/Cashier/Stripe/Webhook): Stripe-Signatur geprüft, max. 256 KB.
• E-Mail (über den SMTP-Server des Registration-Plugins): an den Kunden — Rechnung fällig (3 Tage vorher), Zahlung fehlgeschlagen, Zahlung erfolgreich, Konto gesperrt, Konto reaktiviert (alle standardmäßig an), mit Dienstname, Benutzername, Betrag, Datum, Stripe-Rechnungslink und einem signierten Bezahllink (7 Tage); an den Administrator — Zahlungen und Fehlschläge, über die Kanäle von Registration (E-Mail / Telegram).
• Die Bezahlseite und der TV-QR werden vom Plugin ausgeliefert (QR wird auf dem Server erzeugt, keine externen Ressourcen). Die Admin-Seite enthält nur Links zum Stripe-Dashboard.
• Dazu der Lizenz-Client, in jedem Plugin gleich: siehe Lizenzierung und Datenschutz in unseren Plugins.

Lokal gespeichert:

• data/secrets.json (wird nicht an die Konfiguration gesendet, die an den Browser geht): Stripe-Secret-Key, Webhook-Secret, HMAC-Schlüssel für die Bezahllinks.
• data/subscriptions.json: pro Abonnent — Benutzer-ID und -Name, E-Mail, Stripe-Kunden-/Abonnement-IDs, Status, Tarif, Zeitraum-Daten; Zahlungen (Rechnungs-ID, Betrag, Währung, Ergebnis, Rechnungslink; max. 5000), Journal (max. 2000), verarbeitete Ereignis-IDs (30 Tage).
• Konfiguration: Tarife/Preise, Stripe-IDs (Produkt, Portal, Webhook, Konto), öffentliche Adresse.
• Aufbewahrung: Die Abonnentenzeile wird zusammen mit dem Server-Benutzer gelöscht; gesperrte Konten werden nicht automatisch gelöscht (Standard).

Kompatibilität mit Clients

• Sperren/Reaktivieren von Konten und das pro-Tarif-Limit gleichzeitiger Streams sind serverseitig: 🟢 jeder Client.
• Hinweis: Das Stoppen von Wiedergabe über dem Limit mit dem Befehl „Stop“ wird von Emby Web 4.10 ignoriert; der eigentliche Schutz ist das native Limit gleichzeitiger Streams (Plan Guard übernimmt das Aufpassen, falls installiert).
• Kundenseite (/Cashier/Page): jeder Browser; Fernseher zahlen vom Handy per QR. ✅ End-to-End gegen einen Stripe-Simulator (56/56).
• ❔ Im automatisierten Test noch nicht gegen echtes Stripe getestet (nur Simulator); native Emby-Apps: ❔ nicht getestet.

Legende: ✅ verifiziert (End-to-End- oder Test auf dem Gerät) · 🟢 serverseitig, funktioniert mit jedem Client (konstruktionsbedingt, kein clientspezifischer Test) · ➖ nicht zutreffend · ❔ nicht getestet.

Lizenzierung

Eine Lizenz pro Emby-Server. Monatlich, jährlich oder als Lifetime-Lizenz, oder im Emby-Paket enthalten. 30 Tage kostenlos testen. Das Plugin wird unter unserer EULA lizenziert.

Code von Dritten: Der QR-Code-Generator basiert auf der Bibliothek QR Code generator von Project Nayuki (MIT-Lizenz).

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.