Cobra suscripciones a tu servidor Emby con Stripe: planes, prueba y suspensión

Si gestionas un servidor Emby para un club, un hogar compartido o una pequeña comunidad, ya sabes que lo incómodo no es el streaming, sino la contabilidad. Alguien tiene que recordar quién pagó, perseguir las renovaciones y decidir qué hacer cuando caduca una tarjeta. Cashier traslada ese trabajo a Stripe y al propio Emby: un visitante se registra, elige un plan, paga y la cuenta se activa cuando Stripe confirma el pago. Cuando falla una renovación, la cuenta se suspende —nunca se elimina— hasta que se pague la factura.

Este tutorial repasa la configuración tal como la hice en mi propio servidor, con los ajustes que de verdad importan y los tropiezos con los que me encontré. Se da por hecho que cobras por contenido legal alojado en tu propio servidor; hablamos de ello más abajo.

Antes de empezar

Derechos sobre el contenido. Cashier cobra a tus usuarios a través de tu propia cuenta de Stripe. Solo tú eres responsable de tener los derechos sobre el contenido o el servicio por el que cobras: las películas, series o canales de tu servidor. MediaLab Works únicamente proporciona el software y no es parte de tus ventas. Stripe puede cerrar o restringir una cuenta que cobre por contenido sin los derechos; consulta la lista de negocios restringidos de Stripe. Limita tu biblioteca al contenido que posees o para el que tienes licencia.

Requisitos previos:

• Emby Server 4.10.1 o posterior (Linux, Windows o Docker).
• El plugin Registration 1.10 o posterior, instalado y con licencia. Cashier usa su página de registro, su configuración de correo y sus cuentas; sin él, Cashier muestra el motivo en su página.
• Una cuenta de Stripe (abrirla es gratis; Stripe cobra su propia comisión por pago) y tu servidor accesible por HTTPS, para la página del cliente y el webhook de Stripe.
• Una licencia de MediaLab Works para Cashier: una suscripción activa, una licencia de por vida dentro de su ventana de actualizaciones o la prueba gratuita de 30 días.

Paso 1 — Instala el plugin

1. Inicia sesión en tu cuenta de MediaLab Works, abre Licenses y descarga el DLL del plugin.
2. Cópialo en la carpeta de plugins de Emby y reinicia Emby Server:
   • Linux (paquete): /var/lib/emby/plugins/
   • Docker: la carpeta plugins dentro de tu volumen de configuración de Emby
   • Windows: %AppData%\Emby-Server\programdata\plugins\
3. Abre Cashier en el menú del panel de Emby, pulsa Open License page, pega tu clave de licencia y actívala, o introduce tu correo para empezar la prueba o comprar una licencia. El plugin vincula la clave a este servidor y muestra la licencia como Active.

La licencia se comprueba una vez al día y en cada arranque de Emby. Sin internet, el plugin sigue funcionando 7 días después de la última comprobación correcta y luego se detiene hasta que pueda comprobarla de nuevo. Si alguna vez necesitas volver atrás, esa misma página permite instalar una actualización o revertir a la versión anterior; reinicia Emby después.

Paso 2 — Configura Registration primero

Cashier se apoya en Registration para la página de registro, las cuentas y el servidor de correo. En Registration, configura su dirección pública y su servidor de correo antes de tocar Cashier; de lo contrario, los correos a los clientes no tendrán a dónde ir. Después abre Cashier: la parte superior de la página te indica si Stripe y Registration están conectados.

Paso 3 — Conecta Stripe

En la pestaña Stripe:

1. En Stripe, ve a Developers → API keys y crea una clave restringida con acceso de escritura a Products, Prices, Checkout Sessions, Customer portal, Customers, Subscriptions y Webhook Endpoints, y acceso de lectura a Events e Invoices. La clave secreta estándar también sirve.
2. Pégala y pulsa Save and test.

Empieza con una clave de prueba (sk_test_… / rk_test_…) y la tarjeta 4242 4242 4242 4242. Deja bien todo el flujo en modo de prueba antes de que un solo cliente real vea la página.

Paso 4 — Ajustes: nombre del servicio y dirección pública

En la pestaña Settings, define el nombre del servicio que se muestra a los clientes y en Stripe, y la dirección pública del servidor (por ejemplo, https://emby.example.com). Esa dirección se usa para la vuelta desde Stripe, los enlaces de pago y el webhook.

Después vuelve a Stripe y pulsa Create the webhook automatically. Sin dirección pública, Cashier sigue funcionando —lee los eventos de Stripe cada pocos minutos—, pero el webhook hace que la activación sea instantánea.

Paso 5 — Define tus planes

En la pestaña Plans, revisa cada plan: mensual o anual, el número de reproducciones simultáneas (de 1 a 4 por defecto) y su precio. Un plan para 2 dispositivos permite que la cuenta reproduzca en dos pantallas a la vez. Configura también la moneda, los días de prueba gratuita de la primera suscripción, los días de gracia tras un pago fallido (3 por defecto) y, opcionalmente, los códigos de promoción, la dirección de facturación y Stripe Tax.

Pulsa Save and push to Stripe: el producto y los precios se crean en tu cuenta de Stripe. Hay dos comportamientos que conviene conocer:

• Un precio modificado crea un precio nuevo en Stripe; los suscriptores existentes conservan el suyo hasta que cambian de plan.
• Un plan desactivado deja de ofrecerse.

Paso 6 — Correos y el interruptor de venta

Sigue en Settings y elige qué correos reciben los clientes —recordatorio antes de la siguiente factura (y con cuántos días de antelación), pago fallido, recibo, suspensión, acceso restaurado— y tus propias notificaciones (cada pago, pagos fallidos). Decide si se detiene la reproducción por encima del límite del plan. Después activa Selling is on.

La página del cliente está en /emby/Cashier/Page en la dirección de tu Emby, y las cuentas nuevas de Registration se envían allí automáticamente.

Paso 7 — Prueba el ciclo completo

Con la clave de prueba configurada:

1. Regístrate a través de Registration, elige un plan y paga con la tarjeta de prueba. La cuenta debería quedar activada con el límite de reproducciones del plan.
2. Abre la página del cliente: planes, suscripción actual, próximo pago y un botón Manage subscription que abre el portal de clientes de Stripe (tarjeta, facturas, cambio de plan, cancelación).
3. Haz que falle un pago de prueba y observa el período de gracia, los correos y la suspensión; después paga la factura y confirma que la cuenta vuelve.

Cómo el pago sustituye a la aprobación

Una cuenta creada a través de Registration permanece desactivada hasta que Stripe confirma el pago; entonces se activa con el límite de reproducciones del plan. Ese es todo el modelo: el pago es la aprobación. El impago suspende, nunca elimina: tras un pago fallido la cuenta sigue activa durante el período de gracia mientras Stripe reintenta, y luego se desactiva; al pagar la factura se vuelve a activar. Eliminar cuentas suspendidas durante mucho tiempo es opcional y está desactivado por defecto.

Una cuenta suspendida no puede iniciar sesión, así que recibe un enlace de pago firmado válido durante 7 días, por correo o de tu parte. En un televisor, la página del cliente muestra un código QR para que el cliente pague desde el móvil y el televisor continúe solo.

Pestañas de administración

Todo está en el panel de Emby: Subscribers (acceso, plan, fecha de renovación; copiar o enviar por correo el enlace de pago, eximir del pago, suspender, reactivar, eliminar, abrir en Stripe), Payments (últimas facturas y resultado), Plans, Stripe, Settings y Log (cada cambio de estado). Require payment from an existing account añade una cuenta que creaste antes; permanece suspendida hasta que pague. Las cuentas de administrador nunca se tocan, y desactivar la venta mantiene todas las cuentas tal como están.

Consejos y solución de problemas

• "Registration: missing, too old or stopped" — instala o actualiza Registration a 1.10 o posterior, comprueba su licencia y reinicia Emby.
• Los pagos no activan las cuentas con rapidez — el webhook no puede llegar al servidor. Comprueba que la dirección pública sea accesible por HTTPS desde internet. Cashier se reconcilia con Stripe cada 15 minutos; Check Stripe now en Subscribers lo hace al instante.
• No llegan correos a los clientes — revisa la configuración del servidor de correo en Registration.
• "Selling is off or not configured" — falta la clave, los planes no se enviaron a Stripe o el interruptor de Settings está desactivado.
• La reproducción por encima del límite no se detiene en Emby Web 4.10 — ahí se ignora el comando "Stop"; la protección real es el límite nativo de reproducciones simultáneas. Plan Guard se encarga de vigilarlo si está instalado.
• Caduca la licencia — Cashier se detiene: no hay nuevos registros de pago ni cambios en las cuentas, pero no se elimina nada. Los eventos de Stripe de ese período se leen en cuanto la licencia vuelve a ser válida.

Conclusión

Cashier mantiene aburrida la parte aburrida de un servidor de club: planes por reproducciones simultáneas, Stripe Checkout en las propias páginas de Stripe para que los datos de la tarjeta nunca lleguen a tu servidor, pago que activa e impago que suspende. Configúralo primero en modo de prueba, mantén en orden los derechos de tu contenido y las renovaciones se ocuparán de sí mismas casi solas. La referencia completa está en la guía de usuario; para cualquier otra cosa, consulta la base de conocimiento, las preguntas frecuentes o contacta con nosotros.