Con Sign-up for mailcow, los visitantes pueden crear sus propias cuentas en tu mailcow. Cashier for mailcow te permite vendérselas: planes de buzón y paquetes de dominios, pagados mensual o anualmente con tarjeta a través de tu propia cuenta de Stripe y aplicados en mailcow en cuanto se confirma el pago. Se distribuye en el paquete del mailcow Toolkit (0.4.0 o posterior), tiene su propia licencia y necesita Sign-up.
Qué hace
Tu cuenta de Stripe, tus pagos
- Los pagos van directamente a tu propia cuenta de Stripe. MediaLab Works nunca ve ni procesa los pagos de tus clientes: Cashier se comunica con Stripe desde tu servidor, con tus claves.
- Se recomienda una clave restringida, con permiso de escritura en Customers, Checkout Sessions, Customer portal, Products, Prices, Subscriptions, Subscription items y Webhook Endpoints, y permiso de lectura en Invoices. La clave se comprueba con Stripe, se guarda cifrada en tu servidor y no se vuelve a mostrar nunca.
- El webhook se crea en tu cuenta de Stripe desde la página de administración. Cada evento se verifica por su firma y se procesa una sola vez (un evento repetido no cambia nada), con una versión fija de la API de Stripe.
- Funcionan tanto las claves de prueba como las claves reales; la página muestra qué modo está conectado.
Planes y complementos
- Planes de buzón (un buzón con su cuota) y paquetes de dominios (número de dominios, buzones, alias y cuota por dominio, cuota predeterminada del buzón), con nombres y descripciones en inglés y en rumano.
- Precios mensuales y/o anuales, días de prueba y planes ocultos, accesibles solo con su enlace directo o con un código de invitación.
- Complementos comprados por cantidad: buzones adicionales en cada dominio del paquete, o almacenamiento adicional. Stripe prorratea los cambios de plan y los complementos, que se aplican en mailcow al instante.
- Se rechaza un plan o paquete más pequeño que lo que el cliente usa ahora, indicando qué reducir primero. No se borra nada para que quepa.
Cuando falla un pago
- La cuenta sigue funcionando durante un período de gracia que tú eliges (de 0 a 90 días), y el cliente recibe un correo con el enlace para pagar.
- Tras el período de gracia, la cuenta se suspende. Por defecto, «no sign-in» (sin inicio de sesión): los buzones siguen recibiendo correo, pero nadie puede iniciar sesión y el administrador de dominio está inactivo. En su lugar puedes elegir «inactive» (inactiva): los buzones, el administrador de dominio y los dominios se desactivan en mailcow.
- Un pago restaura la cuenta al instante, exactamente como estaba. Nunca se borra nada.
- Una cancelación lo mantiene todo hasta el final del período pagado. Después, una cuenta creada por la suscripción sigue suspendida; una cuenta que compró un plan después de un registro gratuito vuelve al paquete gratuito si cabe en él.
Para tus clientes
- La suscripción en My account: plan, fecha de renovación, complementos, Change plan y el portal de cliente de Stripe para la tarjeta, las facturas y la cancelación.
- Correos en inglés o en rumano: factura nueva, recibo, pago fallido, suspendida (con el enlace para pagar), activa de nuevo, a punto de terminar y terminada.
- Una página pública,
/mlw-cashier/billing.php, envía por correo el enlace de pago de una factura pendiente a un cliente suspendido que no puede iniciar sesión.
Para ti
- La lista de suscriptores con los ingresos mensuales, cada suscripción enlazada a Stripe, y los eventos recientes de Stripe.
- Concesiones gratuitas: da un plan a una cuenta durante un número de días, sin Stripe.
- Sin licencia no se inicia ningún pago nuevo. Los webhooks de los suscriptores existentes se siguen procesando, y un pago completado mientras tanto espera hasta que vuelva la licencia; las cuentas existentes nunca se tocan.
Requisitos
- El paquete mailcow Toolkit 0.4.0 o posterior en mailcow-dockerized (Linux,
docker compose, systemd); Cashier forma parte del paquete. - Sign-up for mailcow con su propia licencia válida: las cuentas de pago se crean a través de su página de registro.
- Tu propia cuenta de Stripe (en un país en el que Stripe opere) y una clave restringida con los permisos indicados arriba.
- La interfaz de mailcow accesible desde internet por HTTPS, para que Stripe pueda llamar al webhook (
/mlw-cashier/webhook.php). - El servidor debe poder llegar a medialab.works por HTTPS (comprobación de la licencia) y a api.stripe.com.
Preguntas frecuentes
¿Los pagos pasan por MediaLab Works? No. El dinero, las facturas y los datos de los clientes en Stripe están en tu propia cuenta de Stripe; no somos parte de tus ventas. Entre tú y Stripe se aplican las condiciones de Stripe.
¿Qué le pasa a un buzón cuando un cliente deja de pagar? Se suspende tras el período de gracia, nunca se borra. Con el modo predeterminado sigue recibiendo correo, así que no se pierde nada; un pago lo vuelve a activar todo.
¿Puede un cliente pasar a un plan más pequeño? Sí, si lo que usa cabe en el plan nuevo. Si no, el cambio se rechaza y la página dice qué reducir.
¿Dónde se guardan los datos?
Los planes, los clientes y las suscripciones están en la base de datos de mailcow (tablas mlw_ca_*), incluida en las copias de seguridad de mailcow. Las claves de Stripe están cifradas, y la clave para descifrarlas se guarda aparte, en el redis de mailcow.
Licencia
Cashier for mailcow es de código abierto (GPL-3.0), como mailcow y el Toolkit. Lo que compras es la suscripción a las nuevas versiones, las actualizaciones y el soporte para un servidor mailcow, con su propia clave de licencia y su propia prueba gratuita de 30 días; el paquete para mailcow cubre el Toolkit, Sign-up y Cashier con una sola clave. Está escrito en PHP y JavaScript, así que recibes el código fuente completo. Consulta la sección 11 del EULA.
Cashier for mailcow es código propio, escrito por MediaLab Works; no contiene código de terceros ni ningún SDK de Stripe (llama directamente a la API pública de Stripe). mailcow es un proyecto de código abierto independiente (GPL-3.0) de The Infrastructure Company GmbH; Stripe es un servicio de pago independiente, utilizado solo con tu propia cuenta. Consulta Derechos de autor.
