Cashier para Emby — guía de configuración

Instalación

Necesitas Emby Server 4.10.1 o posterior y Registration 1.10 o posterior, instalado y con licencia.

1. Inicia sesión en tu cuenta de MediaLab Works, abre Licenses y descarga el DLL del plugin (disponible con una suscripción activa, con una licencia de por vida dentro de su período de actualizaciones o durante la prueba gratuita de 30 días).
2. Copia el DLL en la carpeta de plugins de Emby y reinicia Emby Server:
   • Linux (paquete): /var/lib/emby/plugins/
   • Docker: la carpeta plugins dentro del volumen de configuración de Emby
   • Windows: %AppData%\Emby-Server\programdata\plugins\
3. Abre Cashier en el menú del panel de Emby y haz clic en Open License page. Pega tu clave de licencia y actívala, o escribe tu correo para empezar la prueba gratuita de 30 días o comprar una licencia. El plugin contacta con el servidor de licencias, vincula la clave a este servidor de Emby 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; después se detiene hasta que pueda comprobarla de nuevo.

Licencia

Sin una licencia válida, Cashier se detiene: la página para clientes indica que las suscripciones no están disponibles, no se aceptan altas de pago nuevas y ninguna cuenta se modifica; solo sigue funcionando la página License (desde ella puedes empezar la prueba, comprar, introducir la clave o actualizar). Los suscriptores, los planes y los ajustes se conservan. No se borra nada: todo se reanuda en cuanto la licencia vuelve a ser válida, y entonces se leen los eventos de Stripe del intervalo.

Con una licencia válida, esa misma página puede instalar una actualización o volver a la versión anterior si una actualización causa problemas. Reinicia Emby después de cualquiera de las dos.

Configuración

Primero configura Registration: su dirección pública y, para los correos a los clientes, su servidor de correo. Después abre Cashier en el panel de Emby. La página tiene seis pestañas: Subscribers, Payments, Plans, Stripe, Settings y Log; la parte superior muestra si Stripe y Registration están conectados.

1. Stripe: en Stripe (Developers → API keys) crea una restricted key con acceso de escritura a Products, Prices, Checkout Sessions, Customer portal, Customers, Subscriptions y Webhook Endpoints, y de lectura a Events e Invoices (también vale la clave secreta estándar). Pégala y haz clic en Save and test. Prueba primero con una clave de prueba (sk_test_… / rk_test_…) y la tarjeta 4242 4242 4242 4242.
2. Settings: el service name que se muestra a los clientes y en Stripe, y la public server address (por ejemplo https://emby.example.com), usada para el regreso desde Stripe, los enlaces de pago y el webhook. Después, en Stripe, haz clic en Create the webhook automatically. Sin una dirección pública, Cashier sigue funcionando leyendo los eventos de Stripe cada pocos minutos.
3. Plans: revisa cada plan (mensual o anual, número de streams simultáneos, precio), la moneda, los días de prueba gratuita, los días de gracia tras un pago fallido y los códigos de descuento, la dirección de facturación y Stripe Tax opcionales. Haz clic en Save and push to Stripe: el producto y los precios se crean en tu cuenta de Stripe. Un precio modificado crea un precio nuevo en Stripe; los suscriptores existentes conservan el suyo hasta que cambian de plan, y un plan desactivado deja de ofrecerse.
4. Settings: elige los correos a los clientes (recordatorio antes de la siguiente factura y cuántos días antes, pago fallido, recibo, suspensión, acceso restablecido), tus propias notificaciones (cada pago, pagos fallidos) y si se detiene la reproducción por encima del límite del plan. Después activa Selling is on.

La página para clientes está en /emby/Cashier/Page en tu dirección de Emby; las cuentas nuevas de Registration se envían allí automáticamente.

Uso diario

• Los clientes nuevos se registran en Registration, eligen un plan y pagan; su cuenta se activa cuando Stripe confirma el pago. Los clientes cambian su tarjeta, su plan o cancelan desde Manage subscription en la página para clientes.
• Subscribers enumera cada cuenta con su acceso, su plan y su fecha de renovación. Desde su fila puedes copiar o enviar por correo el enlace de pago (válido 7 días), eximir la cuenta del pago, suspenderla o reactivarla, quitarla de Cashier o abrirla en Stripe. Require payment from an existing account añade una cuenta que creaste antes; permanece suspendida hasta que paga.
• Payments muestra las facturas más recientes y su resultado; Log muestra cada cambio de estado.
• Desactivar la venta deja cada cuenta tal cual. Cashier solo toca las cuentas de su lista, nunca a los administradores.

Resolución de problemas

• Registration: missing, too old or stopped: instala o actualiza Registration a 1.10 o posterior y comprueba su licencia; después reinicia Emby.
• Los pagos no activan las cuentas rápidamente: el webhook no puede llegar al servidor. Comprueba que la dirección pública sea accesible por HTTPS desde internet; Cashier aun así concilia con Stripe cada 15 minutos (Check Stripe now en Subscribers lo hace al instante).
• No llegan correos a los clientes: comprueba el servidor de correo en los ajustes de Registration.
• Selling is off o no configurado: falta la clave, los planes no se enviaron a Stripe o el interruptor de Settings está desactivado.

Derechos de contenido

Cashier cobra a tus usuarios a través de tu propia cuenta de Stripe. Tú eres el único responsable de poseer los derechos del contenido o servicio por el que cobras (por ejemplo las películas, series o canales de tu servidor); MediaLab Works solo proporciona el software y no es parte en tus ventas. Stripe puede cerrar o restringir una cuenta que cobre por contenido sin los derechos correspondientes: consulta la lista de negocios restringidos de Stripe.