Cashier pour Emby — guide de configuration

Installation

Vous avez besoin d’Emby Server 4.10.1 ou plus récent et de Registration 1.10 ou plus récent, installé et licencié.

Connectez-vous à votre compte MediaLab Works, ouvrez Licences et téléchargez le DLL du plugin (disponible avec un abonnement actif, une licence à vie dans sa période de mises à jour, ou pendant l’essai gratuit de 30 jours).
Copiez le DLL dans le dossier des plugins Emby et redémarrez Emby Server :
- Linux (paquet) : /var/lib/emby/plugins/
- Docker : le dossier plugins dans votre volume de configuration Emby
- Windows : %AppData%\Emby-Server\programdata\plugins\
Ouvrez Cashier dans le menu du tableau de bord Emby et cliquez sur Open License page. Collez votre clé de licence et activez-la, ou saisissez votre e-mail pour démarrer l’essai gratuit de 30 jours ou acheter une licence. Le plugin contacte le serveur de licences, lie la clé à ce serveur Emby et affiche la licence comme Active.

La licence est vérifiée une fois par jour (et à chaque démarrage d’Emby). Sans internet, le plugin continue de fonctionner pendant 7 jours après la dernière vérification réussie ; ensuite, il est arrêté jusqu’à ce qu’il puisse à nouveau vérifier.

Licence

Sans licence valide, Cashier est arrêté : la page client indique que les abonnements ne sont pas disponibles, aucune nouvelle inscription payante n’est acceptée et aucun compte n’est modifié ; seule la page License continue de fonctionner (vous pouvez y démarrer l’essai, acheter, saisir la clé ou mettre à jour). Les abonnés, les formules et les réglages sont conservés. Rien n’est supprimé : tout reprend dès que la licence redevient valide, et les événements Stripe du créneau sont alors lus.

Avec une licence valide, la même page peut installer une mise à jour ou revenir à la version précédente si une mise à jour pose problème. Redémarrez Emby dans les deux cas.

Configuration

Configurez d’abord Registration : son adresse publique et, pour les e-mails aux clients, son serveur e-mail. Ouvrez ensuite Cashier dans le tableau de bord Emby. La page compte six onglets : Subscribers, Payments, Plans, Stripe, Settings et Log ; le haut de la page indique si Stripe et Registration sont connectés.

Stripe : dans Stripe (Developers → API keys), créez une restricted key avec accès en écriture à Products, Prices, Checkout Sessions, Customer portal, Customers, Subscriptions et Webhook Endpoints, et accès en lecture à Events et Invoices (la clé secrète standard fonctionne aussi). Collez-la et cliquez sur Save and test. Testez d’abord avec une clé de test (sk_test_… / rk_test_…) et la carte 4242 4242 4242 4242.
Settings : le nom du service affiché aux clients et dans Stripe, ainsi que l’adresse publique du serveur (p. ex. https://emby.example.com), utilisée pour le retour depuis Stripe, les liens de paiement et le webhook. Cliquez ensuite, dans Stripe, sur Create the webhook automatically. Sans adresse publique, Cashier fonctionne quand même en lisant les événements de Stripe toutes les quelques minutes.
Plans : vérifiez chaque formule (mensuelle ou annuelle, nombre de flux simultanés, prix), la devise, les jours d’essai gratuit, les jours de grâce après un paiement échoué et, en option, les codes de promotion, l’adresse de facturation et Stripe Tax. Cliquez sur Save and push to Stripe : le produit et les prix sont créés dans votre compte Stripe. Un prix modifié crée un nouveau prix Stripe ; les abonnés existants conservent le leur jusqu’à un changement de formule, et une formule désactivée n’est plus proposée.
Settings : choisissez les e-mails aux clients (rappel avant la prochaine facture et combien de jours avant, paiement échoué, reçu, suspension, accès restauré), vos propres notifications (chaque paiement, paiements échoués) et si la lecture au-delà de la limite de la formule est arrêtée. Activez ensuite Selling is on.

La page client se trouve à /emby/Cashier/Page sur votre adresse Emby ; les nouveaux comptes issus de Registration y sont envoyés automatiquement.

Utilisation quotidienne

Les nouveaux clients s’inscrivent dans Registration, choisissent une formule et paient ; leur compte est activé quand Stripe confirme le paiement. Les clients changent de carte, de formule ou résilient via Manage subscription sur la page client.
Subscribers liste chaque compte avec son accès, sa formule et sa date de renouvellement. Depuis sa ligne, vous pouvez copier ou envoyer par e-mail le lien de paiement (valable 7 jours), exempter le compte du paiement, le suspendre ou le réactiver, le retirer de Cashier ou l’ouvrir dans Stripe. Require payment from an existing account ajoute un compte que vous aviez créé avant ; il reste suspendu jusqu’au paiement.
Payments affiche les dernières factures et leur résultat ; Log affiche chaque changement d’état.
Désactiver la vente conserve chaque compte tel quel. Cashier ne touche que les comptes de sa liste, jamais les administrateurs.

Dépannage

Registration : manquant, trop ancien ou arrêté : installez ou mettez à jour Registration vers 1.10 ou plus récent et vérifiez sa licence, puis redémarrez Emby.
Les paiements n’activent pas les comptes rapidement : le webhook ne peut pas atteindre le serveur. Vérifiez que l’adresse publique est joignable en HTTPS depuis internet ; Cashier se réconcilie quand même avec Stripe toutes les 15 minutes (Check Stripe now dans Subscribers le fait immédiatement).
Aucun e-mail aux clients : vérifiez les réglages du serveur e-mail dans Registration.
Selling is off ou non configuré : la clé manque, les formules n’ont pas été poussées vers Stripe ou l’interrupteur dans Settings est désactivé.

Droits sur le contenu

Cashier prélève vos utilisateurs via votre propre compte Stripe. Vous êtes seul responsable de détenir les droits sur le contenu ou le service pour lequel vous facturez (par exemple les films, séries ou chaînes de votre serveur) ; MediaLab Works fournit uniquement le logiciel et n’est pas partie à vos ventes. Stripe peut fermer ou restreindre un compte qui facture du contenu sans les droits — voir la liste restricted businesses de Stripe.