Abonnement Emby avec Stripe : formules, essai et suspension automatique

Si vous gérez un serveur Emby pour un club, un foyer partagé ou une petite communauté, vous savez déjà que le plus pénible n’est pas le streaming : c’est la comptabilité. Il faut se souvenir de qui a payé, relancer les renouvellements et décider quoi faire quand une carte expire. Cashier confie ce travail à Stripe et à Emby lui-même : un visiteur s’inscrit, choisit une formule, paie, et le compte est activé dès que Stripe confirme le paiement. Quand un renouvellement échoue, le compte est suspendu — jamais supprimé — jusqu’au paiement de la facture.

Ce tutoriel déroule l’installation telle que je l’ai faite sur ma propre machine, avec les réglages qui comptent vraiment et les pièges que j’ai rencontrés. Il suppose que vous facturez des médias légaux et auto-hébergés — nous y revenons plus bas.

Avant de commencer

Droits sur les contenus. Cashier encaisse vos utilisateurs via votre propre compte Stripe. Vous seul êtes responsable de détenir les droits sur le contenu ou le service que vous facturez — les films, séries ou chaînes de votre serveur. MediaLab Works ne fournit que le logiciel et n’est pas partie à vos ventes. Stripe peut fermer ou restreindre un compte qui facture des contenus sans les droits ; consultez la liste des activités restreintes de Stripe. Limitez votre bibliothèque à des contenus que vous possédez ou que vous êtes autorisé à utiliser.

Prérequis :

• Emby Server 4.10.1 ou plus récent (Linux, Windows ou Docker).
• Le plugin Registration 1.10 ou plus récent, installé et sous licence. Cashier utilise sa page d’inscription, ses réglages d’e-mail et ses comptes ; sans lui, Cashier affiche la raison sur sa page.
• Un compte Stripe (l’ouverture est gratuite ; Stripe prélève ses propres frais par paiement) et votre serveur joignable en HTTPS, pour la page client et le webhook Stripe.
• Une licence MediaLab Works pour Cashier : un abonnement actif, une licence à vie dans sa fenêtre de mises à jour, ou l’essai gratuit de 30 jours.

Étape 1 — Installer le plugin

1. Connectez-vous à votre compte MediaLab Works, ouvrez Licences et téléchargez la DLL du plugin.
2. Copiez-la dans le dossier des plugins d’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\
3. Ouvrez Cashier dans le menu du tableau de bord Emby, cliquez sur Ouvrir la page de licence, collez votre clé de licence et activez-la — ou saisissez votre e-mail pour démarrer l’essai ou acheter une licence. Le plugin lie la clé à ce serveur 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 7 jours après la dernière vérification réussie, puis s’arrête jusqu’à pouvoir vérifier à nouveau. Si vous devez revenir en arrière, la même page permet d’installer une mise à jour ou de revenir à la version précédente ; redémarrez Emby ensuite.

Étape 2 — Configurer Registration d’abord

Cashier s’appuie sur Registration pour la page d’inscription, les comptes et le serveur d’e-mail. Dans Registration, renseignez son adresse publique et son serveur d’e-mail avant de toucher à Cashier, sinon les e-mails aux clients n’ont nulle part où aller. Ouvrez ensuite Cashier : le haut de la page vous indique si Stripe et Registration sont connectés.

Étape 3 — Connecter Stripe

Dans l’onglet Stripe :

1. Dans Stripe, allez dans Développeurs → Clés API et créez une clé restreinte 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.
2. Collez-la et cliquez sur Enregistrer et tester.

Commencez avec une clé de test (sk_test_… / rk_test_…) et la carte 4242 4242 4242 4242. Validez tout le parcours en mode test avant qu’un seul vrai client ne voie la page.

Étape 4 — Réglages : nom du service et adresse publique

Dans l’onglet Réglages, définissez le nom du service affiché aux clients et dans Stripe, ainsi que l’adresse publique du serveur (par exemple https://emby.example.com). Cette adresse sert au retour depuis Stripe, aux liens de paiement et au webhook.

Revenez ensuite dans Stripe et cliquez sur Créer le webhook automatiquement. Sans adresse publique, Cashier fonctionne quand même — il lit les événements depuis Stripe toutes les quelques minutes — mais le webhook rend l’activation quasi instantanée.

Étape 5 — Définir vos formules

Dans l’onglet Formules, vérifiez chaque formule : mensuelle ou annuelle, le nombre de streams simultanés (1 à 4 par défaut) et son prix. Une formule pour 2 appareils permet au compte de lire sur deux écrans en même temps. Définissez aussi la devise, les jours d’essai gratuit de la première souscription, les jours de grâce après un paiement échoué (3 par défaut), et éventuellement les codes promotionnels, l’adresse de facturation et Stripe Tax.

Cliquez sur Enregistrer et pousser vers Stripe : le produit et les prix sont créés dans votre compte Stripe. Deux comportements méritent d’être connus :

• Un prix modifié crée un nouveau prix Stripe ; les abonnés existants gardent le leur jusqu’à ce qu’ils changent de formule.
• Une formule désactivée n’est plus proposée.

Étape 6 — E-mails et interrupteur de vente

Toujours dans Réglages, choisissez les e-mails envoyés aux clients — rappel avant la prochaine facture (et combien de jours avant), échec de paiement, reçu, suspension, accès rétabli — et vos propres notifications (chaque paiement, paiements échoués). Décidez si la lecture au-delà de la limite de la formule est arrêtée. Activez ensuite La vente est activée.

La page client se trouve à /emby/Cashier/Page sur l’adresse de votre Emby, et les nouveaux comptes créés via Registration y sont envoyés automatiquement.

Étape 7 — Tester tout le cycle

Avec la clé de test en place :

1. Inscrivez-vous via Registration, choisissez une formule et payez avec la carte de test. Le compte doit être activé avec la limite de streams de la formule.
2. Ouvrez la page client : formules, abonnement en cours, prochain paiement et un bouton Gérer l’abonnement qui ouvre le portail client Stripe (carte, factures, changement de formule, résiliation).
3. Faites échouer un paiement de test et observez la période de grâce, les e-mails et la suspension, puis payez la facture et vérifiez que le compte revient.

Comment le paiement remplace la validation

Un compte créé via Registration reste désactivé jusqu’à ce que Stripe confirme le paiement ; il est alors activé avec la limite de streams de la formule. Tout le modèle tient là : le paiement fait office de validation. Le non-paiement suspend, jamais ne supprime — après un paiement échoué, le compte reste actif pendant la période de grâce le temps que Stripe réessaie, puis il est désactivé ; payer la facture le réactive. La suppression des comptes suspendus depuis longtemps est facultative et désactivée par défaut.

Un compte suspendu ne peut pas se connecter : il reçoit donc un lien de paiement signé valable 7 jours, par e-mail ou de votre part. Sur un téléviseur, la page client affiche un QR code pour que le client paie depuis un téléphone et que la TV continue d’elle-même.

Onglets d’administration

Tout se trouve dans le tableau de bord Emby : Abonnés (accès, formule, date de renouvellement ; copier ou envoyer par e-mail le lien de paiement, exempter de paiement, suspendre, réactiver, supprimer, ouvrir dans Stripe), Paiements (dernières factures et résultat), Formules, Stripe, Réglages et Journal (chaque changement d’état). Exiger le paiement d’un compte existant ajoute un compte que vous avez créé auparavant ; il reste suspendu jusqu’à son paiement. Les comptes administrateur ne sont jamais touchés, et désactiver la vente laisse chaque compte tel quel.

Astuces et dépannage

• « Registration : missing, too old or stopped » — installez ou mettez à jour Registration en 1.10 ou plus récent, vérifiez sa licence, redémarrez Emby.
• Les paiements n’activent pas les comptes rapidement — le webhook n’atteint pas le serveur. Vérifiez que l’adresse publique est joignable en HTTPS depuis internet. Cashier se synchronise avec Stripe toutes les 15 minutes ; Vérifier Stripe maintenant dans Abonnés le fait immédiatement.
• Aucun e-mail aux clients — vérifiez les réglages du serveur d’e-mail dans Registration.
• « Selling is off or not configured » — la clé manque, les formules n’ont pas été poussées vers Stripe, ou l’interrupteur dans Réglages est désactivé.
• La lecture au-delà de la limite n’est pas arrêtée sur Emby Web 4.10 — la commande « Stop » y est ignorée ; la vraie protection reste la limite native de streams simultanés. Plan Guard prend le relais de la surveillance s’il est installé.
• La licence expire — Cashier s’arrête : plus de nouvelles inscriptions payantes et plus de modifications de compte, mais rien n’est supprimé. Les événements Stripe de l’intervalle sont lus dès que la licence est de nouveau valide.

Conclusion

Cashier laisse la partie ennuyeuse d’un serveur de club ennuyeuse : formules selon les streams simultanés, Stripe Checkout sur les pages de Stripe pour que les données de carte n’atteignent jamais votre serveur, activation au paiement et suspension en cas de non-paiement. Installez-le d’abord en mode test, gardez vos droits sur les contenus en ordre, et les renouvellements s’occupent surtout d’eux-mêmes. La référence complète est dans le guide utilisateur ; pour le reste, voyez la base de connaissances, la FAQ ou contactez-nous.