Iniciar una Suscripción de Listado (Admin)
Para el personal y los administradores de HiLucy. Esta página es solo para administradores. Existe para que podamos iniciar la suscripción de un propietario y guardar su tarjeta mientras conducimos, el propietario está al teléfono, a mitad del asistente o bloqueado por un problema de inicio de sesión, sin esperar a que se registre por su cuenta a través de
/subscribe.
La página de Suscripción es la contraparte del lado del operador del flujo de suscripción del huésped. Todo se completa previamente desde el listado, así que estás confirmando y cobrando una tarjeta, no reingresando datos. Ábrela poniendo un listado en foco y eligiendo Suscripción bajo el grupo Dinero, lo que resuelve a /admin/listings/<id>/subscription.
Qué completa previamente
No se vuelve a preguntar nada. La página lee el listado para completar:
- Propietario — la cuenta del propietario reclamado a la que se factura la suscripción. Si el listado no tiene un propietario reclamado, no puedes iniciar una suscripción; primero haz que el propietario reclame el listado.
- Plan — Hotel o Alquiler vacacional, según el tipo de listado.
- Habitaciones (solo hoteles) — el conteo de habitaciones facturables, primero desde los tipos de habitación publicados y luego desde el total de onboarding.
- Vista previa del precio — base más, para los hoteles, habitaciones × tarifa por habitación, con el total mensual posterior a la prueba.
Las tres fases
1. Revisión
Confirma el propietario, el plan y el conteo de habitaciones. Para un hotel puedes ajustar el campo Habitaciones hacia arriba o hacia abajo; el total se recalcula en vivo. La línea de precio se lee como base + habitaciones × tarifa por habitación, coincidiendo con la misma fórmula con la que factura el canal de autoservicio.
Cuando estés listo, haz clic en Iniciar prueba de [30] días y guardar tarjeta. Eso crea la suscripción en prueba en segundo plano y devuelve un secreto de configuración de Stripe para que puedas cobrar la tarjeta.
2. Tarjeta en archivo (Stripe SetupIntent)
El formulario de la tarjeta es Stripe Elements. La tarjeta del propietario va del navegador a Stripe directamente, así que los números de tarjeta nunca tocan los servidores de HiLucy; solo pasan los identificadores del método de pago y del setup intent de Stripe. Ingresa la tarjeta y haz clic en Guardar tarjeta y activar.
Hoy no se cobra nada. Como dice el formulario, la tarjeta va directo a Stripe y se factura automáticamente cuando termina la prueba de 30 días. Detrás de ese único botón, HiLucy adjunta la tarjeta confirmada como el método de pago predeterminado del propietario y luego activa el listado (a menos que ya esté activo).
3. Listo
Llegas a una confirmación: suscripción activa, tarjeta en archivo, propietario en una prueba de 30 días, con el primer cargo mensual mostrado. Si el listado ya tenía una suscripción, la página muestra su tarjeta de estado en lugar del flujo de inicio. Un propietario solo puede tener una suscripción activa, así que iniciar una segunda se rechaza.
Manejo de la prueba
Cada inicio crea una prueba de 30 días. La prueba comienza ahora y la tarjeta se factura al final de la prueba. Como el flujo de administración es un envoltorio ligero sobre el mismo canal que el propietario usa cuando se suscribe por su cuenta, la mecánica de la prueba, los webhooks de facturación y el correo de bienvenida son idénticos al autoservicio. No hay un comportamiento de facturación exclusivo de administración que haya que considerar.
Mantenerlo gratis
Algunos listados deberían activarse sin facturación (un piloto, una cortesía, un amigo de la casa). En la pantalla de revisión, cuando el listado todavía no está activo, obtienes un segundo botón:
- Activar gratis — sin facturación. El listado se activa sin suscripción. Nada se cobra hasta que decidas iniciar una, y puede quedar gratis para siempre.
Puedes empezar a facturar más tarde en cualquier momento desde esta misma página. Si un listado ya está activo de forma gratuita, la pantalla de revisión lo indica y simplemente ofrece iniciar una suscripción cuando quieras.
Activación idempotente
La activación no se vuelve a ejecutar a ciegas. Vuelve a transferir la propiedad, vuelve a disparar los hooks de onboarding y reenvía el correo de bienvenida, así que volver a ejecutarla en un listado activo sería disruptivo. HiLucy protege contra eso: si el listado ya está activo y es propiedad de este propietario, el paso de activación se cortocircuita a un éxito sin operación en lugar de pisar el estado activo. Esto es lo que hace seguro guardar una tarjeta en un listado que ha estado activo y gratis durante meses; estás agregando facturación, no reactivando nada.
Rastro de auditoría
Como esto mueve dinero desde el lado del operador, cada inicio, confirmación de tarjeta y activación escribe una entrada en el libro contable financiero que nombra al administrador que la realizó. La facturación gestionada por administración siempre es atribuible.