Faturamento - Visão Geral

O que é

A página Plano Atual (/admin/billing) é o centro de controle da assinatura da sua empresa no Viagilize. Em um só lugar, ela mostra qual plano está vigente, o valor da mensalidade (mensal ou anual), o status atual da cobrança, a data da próxima fatura, os módulos contratados, eventuais valores em trial, ajustes proporcionais e o saldo da carteira de créditos. É também onde o usuário paga com PIX ou cartão, troca de plano, monta um combo de plano + módulos, agenda downgrade, cancela ou reativa a assinatura.

O usuário normalmente chega aqui no início para escolher um plano pago, sempre que recebe um aviso de cobrança pendente, próximo do vencimento mensal/anual, ao decidir fazer upgrade para liberar limites ou contratar módulos extras, e quando precisa baixar a nota/recibo na seção de Histórico de Pagamentos.

Como usar

1. No menu lateral, clique em Plano Atual. A URL canônica é /admin/billing.
2. No topo, leia o card Plano Atual com o nome do plano e o selo de status: Ativo, Trial, Cortesia, Aguardando Pagamento, Pagamento Pendente, Vencido, Período Expirado ou Cancelamento Agendado. À direita aparece o preço - R$ X,XX/mês ou R$ X,XX/ano.
3. Confira a data informada logo abaixo: Próxima cobrança, Trial expira em, Acesso até (cancelamento agendado) ou Período gratuito termina em, com os dias restantes.
4. Se houver cobrança em aberto, use o banner amarelo Ative sua Assinatura / Pagamento Pendente com os botões Pagar com PIX (verde-azulado) ou Pagar com Cartão (azul). O PIX abre em modal; o cartão redireciona para a página do meio de pagamento.
5. Quando faltarem 7 dias ou menos para o vencimento, aparece o banner Renove sua Assinatura com os botões Renovar com PIX e Renovar com Cartão - ambos consolidam plano + módulos no mesmo pagamento.
6. Se houver crédito na carteira de afiliados, o card verde Saldo da Carteira mostra o valor, abatido automaticamente da próxima fatura.
7. Role até Resumo da Assinatura para conferir os itens cobrados: plano base, módulos ativos, módulos em teste, módulos expirados que entram na renovação e ajustes proporcionais. Os subtotais aparecem em Plano Base, Módulos (N) e Total Mensal / Total Anual.
8. Para trocar de plano, role até a seção Planos, use o toggle Mensal / Anual (a versão anual mostra a economia de -17%) e clique em Fazer Upgrade, Assinar Anual, Mudar para este ou Assinar Agora no cartão escolhido. Upgrades pagos geram um PIX proporcional; downgrades são agendados para o fim do período atual.
9. Em Módulos Extras, no fim da página, ative módulos individualmente - para o catálogo completo, abra o artigo da Loja de Módulos.
10. Para encerrar a assinatura, clique em Cancelar Assinatura (botão vermelho no card no fim da página). O acesso continua até o fim do período pago.
11. Para abrir o histórico, clique em Histórico de Pagamentos no canto superior direito.

Casos especiais

Plano gratuito (free) com módulos pagos

empresas em plano free que querem contratar módulos pagos precisam primeiro virar pagantes. Quando o status permite (free, trial ou pending sem PIX em aberto) e há planos pagos cadastrados, aparece o botão Assinar Plano + Módulos no topo direito. Ele abre o modal de combo, onde você escolhe plano + módulos e recebe um único PIX no valor consolidado. A ativação efetiva acontece após a confirmação do pagamento pelo webhook.

Pagamento pendente desatualizado

Se você adiciona ou remove módulos enquanto há um PIX em aberto, o sistema compara o valor do PIX com o esperado (plano + módulos renováveis). Se a diferença for maior que R$ 0,01, o PIX antigo é cancelado automaticamente e um novo é gerado com o valor correto. Por isso, esperar para pagar um PIX antigo pode resultar em link expirado - sempre use o botão atual.

Upgrade proporcional

Ao escolher um plano superior, o sistema calcula a diferença proporcional aos dias restantes do ciclo atual. O upgrade só é aplicado depois do pagamento desse valor proporcional. O ciclo de cobrança não muda - a próxima cobrança continua na data original.

Downgrade agendado

A troca para um plano inferior fica agendada para o fim do período atual. Enquanto isso, o card Plano Atual mostra o alerta azul Downgrade agendado, com o nome do novo plano, o preço e a data prevista. É possível cancelar pelo link Cancelar downgrade dentro do próprio alerta.

Cancelamento agendado

Após Cancelar Assinatura, você continua com acesso até o fim do ciclo pago. O card Plano Atual exibe o alerta laranja Cancelamento Agendado com a data e o link Reativar assinatura para desfazer o pedido antes do vencimento.

empresa em cortesia (gift)

Quando billing_period = 'gift', o plano aparece com selo verde Cortesia e o resumo mostra Cortesia no lugar do preço. O valor não entra no total e não é gerado PIX da mensalidade - apenas módulos pagos contratados à parte cobram normalmente.

Trial do plano

Durante o período de teste do plano, o card mostra selo Trial, uma barra de progresso amarela com N dias restantes (sobre 14 dias) e a data de expiração. Para virar pagante antes do fim do trial, use Assinar Plano + Módulos ou clique em qualquer cartão da seção Planos.

Período vencido (carência de 7 dias)

Se a data passou e o pagamento não foi feito, o card mostra selo vermelho Vencido ou Período Expirado e o aviso de bloqueio iminente com os dias restantes. Após 7 dias sem pagamento, a conta é movida para a tela de bloqueio (/admin/subscription/blocked).

Módulos em trial saindo junto com a assinatura

Quando há módulos em trial cujo fim coincide ou é anterior à próxima cobrança do plano, o resumo mostra a linha extra Total ao renovar em destaque azul, somando plano + módulos saindo do trial. O bloco informativo Como funciona o trial dos módulos lembra que sem assinatura ativa os módulos param de funcionar e que não há cobrança automática - você decide se renova.

Módulos expirados na lista

Módulos pagos cujo período venceu aparecem em vermelho com o aviso Expirado - renove sua assinatura e o botão Remover (ícone de lixeira). Remover preserva o histórico e libera o slot da lista; uma nova contratação pode ser feita depois pela Loja de Módulos.

Status pending sem PIX gerado

Se você é movido para pending (ex.: criação de conta, upgrade vindo do plano gratuito) e ainda não há PIX, a própria página de Plano Atual gera o PIX automaticamente na primeira visita, com o valor consolidado de plano + módulos ativos.

Erros comuns e como resolver

• "Plano gratuito não requer pagamento." - Causa: clique em PIX/cartão com plan_price = 0. Solução: escolha primeiro um plano pago em Planos ou use Assinar Plano + Módulos.
• "Não é possível criar checkout para plano gratuito." - Causa: tentativa de gerar checkout via cartão estando no plano gratuito. Solução: assine um plano pago antes.
• "Você já está neste plano." - Causa: clique em mudar para o plano que já está ativo. Solução: nenhuma ação necessária.
• "Sua assinatura não está cancelada." - Causa: clique em Reativar assinatura sem cancelamento agendado. Solução: ignore - a assinatura já está ativa.
• "Selecione um plano pago para reativar a assinatura." - Causa: na tela de bloqueio, tentativa de trocar para plano gratuito. Solução: escolha um dos planos pagos.
• "Erro ao gerar PIX. Verifique as credenciais." - Causa: falha de comunicação com o meio de pagamento (Mercado Pago/Asaas/Pagar.me/InfinitePay) ou credenciais ausentes no central. Solução: tente novamente em alguns minutos; se persistir, abra chamado no Suporte.
• "Selecione um plano pago." (combo) - Causa: combo iniciado com plan_slug gratuito. Solução: selecione um plano pago no modal Assinar Plano + Módulos.
• "Plano não encontrado." - Causa: o plan_slug enviado não existe em billing_plans ou está inativo. Solução: recarregue a página e tente de novo a partir da lista atualizada.

Onde encontrar

• URL: /admin/billing
• Caminho no menu: Plano Atual
• Permissão necessária: nenhuma específica - a página fica visível para qualquer usuário da sua empresa, mas papéis com poder sobre billing (Proprietário, Gerente) são os recomendados para mudar de plano, cancelar ou pagar
• Módulo necessário: nenhum (página fixa da plataforma)

Veja também

• Faturamento - Loja de Módulos
• Faturamento - Carteira de Créditos