Iniciar uma Assinatura de Listing (Admin)
Para a equipe e os administradores da HiLucy. Esta página é exclusiva para administradores. Ela existe para que possamos iniciar a assinatura de um proprietário e salvar o cartão dele enquanto estamos dirigindo, o proprietário está ao telefone, no meio do assistente ou travado por um problema de login, sem esperar que ele se cadastre por conta própria pelo
/subscribe.
A página de Assinatura é a contraparte, do lado do operador, do fluxo de assinatura do hóspede. Tudo é preenchido a partir do listing, então você está confirmando e coletando um cartão, não reinserindo dados. Abra-a colocando um listing em foco e escolhendo Assinatura no grupo Dinheiro, o que resolve para /admin/listings/<id>/subscription.
O que ela preenche
Nada é perguntado de novo. A página lê o listing para preencher:
- Proprietário — a conta do proprietário reivindicado a quem a assinatura é cobrada. Se o listing não tem um proprietário reivindicado, você não pode iniciar uma assinatura; peça ao proprietário que reivindique o listing primeiro.
- Plano — Hotel ou Aluguel por temporada, a partir do tipo de listing.
- Quartos (apenas hotéis) — a contagem de quartos faturáveis, primeiro a partir dos tipos de quarto publicados e depois do total de onboarding.
- Prévia do preço — base mais, para hotéis, quartos × taxa por quarto, com o total mensal após o período de teste.
As três fases
1. Revisão
Confirme o proprietário, o plano e a contagem de quartos. Para um hotel você pode ajustar o campo Quartos para cima ou para baixo; o total é recalculado ao vivo. A linha de preço aparece como base + quartos × taxa por quarto, correspondendo à mesma fórmula com que o canal de autoatendimento fatura.
Quando estiver pronto, clique em Iniciar teste de [30] dias e salvar cartão. Isso cria a assinatura em teste nos bastidores e retorna um setup secret do Stripe para que você possa coletar o cartão.
2. Cartão em arquivo (Stripe SetupIntent)
O formulário do cartão é o Stripe Elements. O cartão do proprietário vai do navegador direto para o Stripe, então os números de cartão nunca tocam os servidores da HiLucy; apenas os identificadores do método de pagamento e do setup intent do Stripe passam por eles. Insira o cartão e clique em Salvar cartão e ativar.
Nada é cobrado hoje. Como diz o formulário, o cartão vai direto para o Stripe e é cobrado automaticamente quando o teste de 30 dias termina. Por trás desse único botão, a HiLucy anexa o cartão confirmado como método de pagamento padrão do proprietário e então ativa o listing (a menos que já esteja no ar).
3. Concluído
Você chega a uma confirmação: assinatura ativa, cartão em arquivo, proprietário em um teste de 30 dias, com a primeira cobrança mensal exibida. Se o listing já tinha uma assinatura, a página mostra seu card de status em vez do fluxo de início. Um proprietário só pode ter uma assinatura ativa, então iniciar uma segunda é recusado.
Tratamento do teste
Todo início cria um teste de 30 dias. O teste começa agora e o cartão é cobrado ao final do teste. Como o fluxo admin é um invólucro leve sobre exatamente o mesmo canal que o proprietário usa quando se assina sozinho, a mecânica do teste, os webhooks de cobrança e o e-mail de boas-vindas são idênticos ao autoatendimento. Não há comportamento de cobrança exclusivo do admin para se preocupar.
Manter gratuito
Alguns listings devem ir ao ar sem cobrança (um piloto, uma cortesia, um amigo da casa). Na tela de revisão, quando o listing ainda não está no ar, você recebe um segundo botão:
- Ativar gratuitamente — sem cobrança. O listing vai ao ar sem assinatura. Nada é cobrado até você decidir iniciar uma, e ele pode ficar gratuito para sempre.
Você pode começar a cobrar depois, a qualquer momento, por esta mesma página. Se um listing já está no ar de forma gratuita, a tela de revisão informa isso e simplesmente oferece iniciar uma assinatura quando você quiser.
Ativação idempotente
A ativação não é reexecutada às cegas. Ela retransfere a propriedade, redispara os hooks de onboarding e reenvia o e-mail de boas-vindas, então reexecutá-la em um listing no ar seria disruptivo. A HiLucy protege contra isso: se o listing já está no ar e pertence a este proprietário, a etapa de ativação se encerra como um sucesso sem operação, em vez de sobrescrever o estado ativo. É isso que torna seguro salvar um cartão em um listing que ficou no ar e gratuito por meses; você está adicionando cobrança, não reativando nada.
Trilha de auditoria
Como isso movimenta dinheiro pelo lado do operador, cada início, confirmação de cartão e ativação grava uma entrada no livro-razão financeiro nomeando o administrador que a realizou. A cobrança conduzida pelo admin é sempre atribuível.