Abonament Emby prin Stripe: planuri, perioadă de probă și suspendare automată

Dacă administrezi un server Emby pentru un club, o gospodărie comună sau o comunitate mică, știi deja că partea incomodă nu este streamingul — ci evidența plăților. Cineva trebuie să țină minte cine a plătit, să urmărească reînnoirile și să decidă ce se întâmplă când un card expiră. Cashier mută această muncă în Stripe și în Emby: un vizitator se înscrie, alege un plan, plătește, iar contul este activat când Stripe confirmă plata. Când o reînnoire eșuează, contul este suspendat — niciodată șters — până la achitarea facturii.

Acest tutorial parcurge configurarea așa cum am făcut-o pe propriul meu server, cu setările care contează cu adevărat și cu capcanele pe care le-am întâlnit. Presupune că percepi taxe pentru conținut media legal, găzduit pe propriul server — mai multe despre asta mai jos.

Înainte de a începe

Drepturile asupra conținutului. Cashier le percepe utilizatorilor taxe prin propriul tău cont Stripe. Doar tu ești responsabil pentru deținerea drepturilor asupra conținutului sau serviciului pentru care percepi taxe — filmele, serialele sau canalele de pe serverul tău. MediaLab Works oferă doar software-ul și nu este parte în vânzările tale. Stripe poate închide sau restricționa un cont care percepe taxe pentru conținut fără drepturi; vezi lista Stripe de restricted businesses. Păstrează în bibliotecă doar conținut pe care îl deții sau pentru care ai licență.

Cerințe preliminare:

• Emby Server 4.10.1 sau mai nou (Linux, Windows sau Docker).
• Pluginul Registration 1.10 sau mai nou, instalat și licențiat. Cashier folosește pagina sa de înscriere, setările sale de e-mail și conturile sale; fără el, Cashier afișează motivul pe pagina sa.
• Un cont Stripe (deschiderea este gratuită; Stripe percepe propriul comision pentru fiecare plată) și serverul tău accesibil prin HTTPS, pentru pagina clientului și pentru webhook-ul Stripe.
• O licență MediaLab Works pentru Cashier: un abonament activ, o licență pe viață în perioada sa de actualizări sau perioada de probă gratuită de 30 de zile.

Pasul 1 — Instalează pluginul

1. Autentifică-te în contul tău MediaLab Works, deschide Licenses și descarcă DLL-ul pluginului.
2. Copiază-l în folderul de pluginuri 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 în meniul dashboard-ului Emby, apasă Open License page, lipește cheia de licență și activeaz-o — sau introdu e-mailul pentru a începe perioada de probă ori pentru a cumpăra o licență. Pluginul leagă cheia de acest server și afișează licența ca Active.

Licența este verificată o dată pe zi și la fiecare pornire a Emby. Fără internet, pluginul funcționează încă 7 zile după ultima verificare reușită, apoi se oprește până când poate verifica din nou. Dacă vreodată trebuie să revii, aceeași pagină poate instala o actualizare sau poate reveni la versiunea anterioară; repornește Emby după aceea.

Pasul 2 — Configurează mai întâi Registration

Cashier se bazează pe Registration pentru pagina de înscriere, conturi și serverul de e-mail. În Registration, setează adresa sa publică și serverul de e-mail înainte de a atinge Cashier, altfel e-mailurile către clienți nu au unde să ajungă. Apoi deschide Cashier: partea de sus a paginii îți spune dacă Stripe și Registration sunt conectate.

Pasul 3 — Conectează Stripe

În fila Stripe:

1. În Stripe, mergi la Developers → API keys și creează o cheie restricționată cu acces de scriere la Products, Prices, Checkout Sessions, Customer portal, Customers, Subscriptions și Webhook Endpoints, și acces de citire la Events și Invoices. Cheia secretă standard funcționează și ea.
2. Lipește-o și apasă Save and test.

Începe cu o cheie de test (sk_test_… / rk_test_…) și cu cardul 4242 4242 4242 4242. Verifică întregul flux în modul de test înainte ca un singur client real să vadă pagina.

Pasul 4 — Setări: numele serviciului și adresa publică

În fila Settings, setează numele serviciului afișat clienților și în Stripe, precum și adresa publică a serverului (de exemplu https://emby.example.com). Această adresă este folosită pentru întoarcerea din Stripe, pentru linkurile de plată și pentru webhook.

Apoi revino la Stripe și apasă Create the webhook automatically. Fără o adresă publică, Cashier funcționează totuși — citește evenimentele din Stripe la fiecare câteva minute — dar webhook-ul face activarea să pară instantanee.

Pasul 5 — Definește planurile

În fila Plans, verifică fiecare plan: lunar sau anual, numărul de redări simultane (1 până la 4 implicit) și prețul său. Un plan pentru 2 dispozitive permite contului să redea pe două ecrane în același timp. Setează de asemenea moneda, zilele de probă gratuită pentru primul abonament, zilele de grație după o plată eșuată (3 implicit) și, opțional, codurile promoționale, adresa de facturare și Stripe Tax.

Apasă Save and push to Stripe: produsul și prețurile sunt create în contul tău Stripe. Două comportamente merită cunoscute:

• Un preț modificat creează un preț Stripe nou; abonații existenți îl păstrează pe al lor până când își schimbă planul.
• Un plan dezactivat nu mai este oferit.

Pasul 6 — E-mailuri și comutatorul de vânzare

Tot în Settings, alege ce e-mailuri ajung la clienți — memento înainte de următoarea factură (și cu câte zile înainte), plată eșuată, chitanță, suspendare, acces restabilit — și notificările tale (fiecare plată, plăți eșuate). Decide dacă redarea peste limita planului este oprită. Apoi activează Selling is on.

Pagina clientului se află la /emby/Cashier/Page pe adresa ta Emby, iar conturile noi din Registration sunt trimise acolo automat.

Pasul 7 — Testează întregul ciclu

Cu cheia de test configurată:

1. Înscrie-te prin Registration, alege un plan și plătește cu cardul de test. Contul ar trebui să fie activat cu limita de redări a planului.
2. Deschide pagina clientului: planuri, abonamentul curent, următoarea plată și un buton Manage subscription care deschide portalul clientului Stripe (card, facturi, schimbare de plan, anulare).
3. Lasă o plată de test să eșueze și urmărește perioada de grație, e-mailurile și suspendarea, apoi achită factura și confirmă că contul revine.

Cum plata înlocuiește aprobarea

Un cont creat prin Registration rămâne dezactivat până când Stripe confirmă plata; apoi este activat cu limita de redări a planului. Acesta este întregul model: plata este aprobarea. Neplata suspendă, nu șterge niciodată — după o plată eșuată contul rămâne activ pe durata perioadei de grație cât timp Stripe reîncearcă, apoi este dezactivat; achitarea facturii îl activează din nou. Ștergerea conturilor suspendate de mult timp este opțională și dezactivată implicit.

Un cont suspendat nu se poate autentifica, așa că primește un link de plată semnat valabil 7 zile, prin e-mail sau de la tine. Pe un televizor, pagina clientului afișează un cod QR, astfel încât clientul plătește de pe telefon, iar televizorul continuă de la sine.

Filele de administrare

Totul este în dashboard-ul Emby: Subscribers (acces, plan, data reînnoirii; copiază sau trimite prin e-mail linkul de plată, scutire de plată, suspendare, reactivare, eliminare, deschidere în Stripe), Payments (ultimele facturi și rezultatul lor), Plans, Stripe, Settings și Log (fiecare schimbare de stare). Require payment from an existing account adaugă un cont creat anterior; acesta rămâne suspendat până când plătește. Conturile de administrator nu sunt niciodată atinse, iar dezactivarea vânzării păstrează fiecare cont așa cum este.

Sfaturi și depanare

• „Registration: missing, too old or stopped” — instalează sau actualizează Registration la 1.10 sau mai nou, verifică licența sa, repornește Emby.
• Plățile nu activează conturile rapid — webhook-ul nu poate ajunge la server. Verifică dacă adresa publică este accesibilă prin HTTPS din internet. Cashier se reconciliază cu Stripe la fiecare 15 minute; Check Stripe now în Subscribers face acest lucru imediat.
• Niciun e-mail către clienți — verifică setările serverului de e-mail în Registration.
• „Selling is off or not configured” — lipsește cheia, planurile nu au fost trimise în Stripe sau comutatorul din Settings este oprit.
• Redarea peste limită nu este oprită pe Emby Web 4.10 — comanda „Stop” este ignorată acolo; protecția reală este limita nativă de redări simultane. Plan Guard preia monitorizarea dacă este instalat.
• Licența expiră — Cashier se oprește: fără înscrieri plătite noi și fără modificări de conturi, dar nimic nu este șters. Evenimentele Stripe din acest interval sunt citite imediat ce licența este din nou validă.

Concluzie

Cashier menține partea plictisitoare a unui server de club plictisitoare: planuri după redări simultane, Stripe Checkout pe paginile proprii Stripe, astfel încât datele cardului să nu ajungă niciodată pe serverul tău, plată care activează și neplată care suspendă. Configurează-l mai întâi în modul de test, păstrează-ți drepturile asupra conținutului în ordine, iar reînnoirile se rezolvă în mare parte singure. Referința completă este în user guide; pentru orice altceva, vezi Bază de cunoștințe, FAQ sau contactează-ne.