Cashier pentru Emby — ghid de configurare

Instalare

Ai nevoie de Emby Server 4.10.1 sau mai nou și de Registration 1.10 sau mai nou, instalat și licențiat.

  1. Autentifică-te în contul MediaLab Works, deschide Licențe și descarcă DLL-ul plugin-ului (disponibil pe abonament activ, licență lifetime în fereastra de actualizări sau în perioada de probă de 30 de zile).
  2. Copiază DLL-ul în folderul de plugin-uri Emby și repornește Emby Server:
    • Linux (pachet): /var/lib/emby/plugins/
    • Docker: folderul plugins din volumul de configurare Emby
    • Windows: %AppData%\Emby-Server\programdata\plugins\
  3. Deschide Cashier din meniul tabloului de bord Emby și apasă Deschide pagina Licență. Lipește cheia de licență și activeaz-o sau scrie adresa de e-mail ca să pornești proba gratuită de 30 de zile ori să cumperi o licență. Plugin-ul contactează serverul de licențe, leagă cheia de acest server Emby și afișează licența ca Activă.

Licența se verifică o dată pe zi (și la fiecare pornire Emby). Fără internet plugin-ul funcționează 7 zile de la ultima verificare reușită; după aceea se oprește până poate verifica din nou.

Licență

Fără licență validă Cashier este oprit: pagina clientului spune că abonamentele nu sunt disponibile, nu se mai primesc înscrieri plătite noi și nu se schimbă niciun cont; doar pagina Licență funcționează (de acolo pornești proba, cumperi, introduci cheia sau actualizezi). Abonații, planurile și setările se păstrează. Nimic nu se șterge: totul repornește imediat ce licența e din nou validă, iar evenimentele Stripe din acest timp se citesc atunci.

Cu o licență validă, aceeași pagină poate instala o actualizare sau poate reveni la versiunea anterioară dacă o actualizare face probleme. Repornește Emby după oricare dintre ele.

Configurare

Configurează întâi Registration: adresa lui publică și, pentru e-mailurile către clienți, serverul de e-mail. Apoi deschide Cashier din tabloul de bord Emby. Pagina are șase file: Abonați, Plăți, Planuri, Stripe, Setări și Jurnal; partea de sus arată dacă Stripe și Registration sunt conectate.

  1. Stripe: în Stripe (Developers → API keys) creează o cheie restricționată cu drept de scriere pentru Products, Prices, Checkout Sessions, Customer portal, Customers, Subscriptions și Webhook Endpoints și drept de citire pentru Events și Invoices (merge și cheia secretă standard). Lipește-o și apasă Salvează și testează. Testează întâi cu o cheie de test (sk_test_… / rk_test_…) și cardul 4242 4242 4242 4242.
  2. Setări: numele serviciului afișat clienților și în Stripe și adresa publică a serverului (de exemplu https://emby.example.com), folosită la întoarcerea din Stripe, în linkurile de plată și pentru webhook. Apoi, în Stripe, apasă Creează webhook-ul automat. Fără adresă publică Cashier funcționează în continuare, citind evenimentele din Stripe la câteva minute.
  3. Planuri: verifică fiecare plan (lunar sau anual, numărul de redări simultane, prețul), moneda, zilele de probă gratuită, zilele de grație după o plată eșuată și opțiunile pentru coduri promoționale, adresa de facturare și Stripe Tax. Apasă Salvează și trimite în Stripe: produsul și prețurile se creează în contul tău Stripe. Un preț schimbat creează un preț Stripe nou; abonații existenți îl păstrează pe al lor până schimbă planul, iar un plan dezactivat nu se mai oferă.
  4. Setări: alege e-mailurile către clienți (amintire înainte de factura următoare și cu câte zile înainte, plată eșuată, chitanță, suspendare, acces redat), notificările tale (la fiecare plată, la plățile eșuate) și dacă redarea peste limita planului se oprește. Apoi pornește Vânzarea este pornită.

Pagina clientului este la /emby/Cashier/Page pe adresa ta Emby; conturile noi din Registration ajung acolo automat.

Folosire zilnică

  • Clienții noi se înregistrează în Registration, aleg un plan și plătesc; contul se activează când Stripe confirmă plata. Cardul, planul sau anularea le schimbă singuri din Gestionează abonamentul, în pagina clientului.
  • Abonați listează fiecare cont cu accesul, planul și data reînnoirii. Din rândul lui poți copia sau trimite pe e-mail linkul de plată (valabil 7 zile), îl poți scuti de plată, suspenda sau reactiva, scoate din Cashier sau deschide în Stripe. Cere plată de la un cont existent adaugă un cont creat înainte; rămâne suspendat până plătește.
  • Plăți arată ultimele facturi și rezultatul lor; Jurnal arată fiecare schimbare de stare.
  • Oprirea vânzării lasă fiecare cont cum este. Cashier atinge doar conturile din lista lui, niciodată administratorii.

Depanare

  • Registration: lipsește, e prea vechi sau e oprit: instalează sau actualizează Registration la 1.10 sau mai nou și verifică-i licența, apoi repornește Emby.
  • Plățile nu activează conturile repede: webhook-ul nu ajunge la server. Verifică dacă adresa publică e accesibilă prin HTTPS din internet; Cashier se reconciliază oricum cu Stripe la fiecare 15 minute (Verifică acum în Stripe din Abonați o face imediat).
  • Nu pleacă e-mailuri către clienți: verifică setările serverului de e-mail din Registration.
  • Vânzarea e oprită sau neconfigurată: lipsește cheia, planurile nu au fost trimise în Stripe sau comutatorul din Setări e oprit.