Faturamento - Formas de Pagamento

O que é

A página de Faturamento é o local onde você paga a assinatura do Viagilize. O Viagilize aceita duas formas de pagamento para a mensalidade ou anuidade do plano: PIX (com QR Code e código copia-e-cola gerados na hora) e cartão de crédito (via checkout do Mercado Pago). Não há cadastro permanente de cartão dentro do Viagilize - cada cobrança gera um novo PIX ou um novo link de checkout, e o sistema confirma o pagamento automaticamente por webhook.

Você costuma chegar aqui em três momentos: ao ativar a primeira assinatura paga (banner amarelo "Ative sua Assinatura"), quando a renovação se aproxima (card azul/laranja/vermelho de "Renove sua Assinatura") ou quando há cobrança em aberto pendente. O valor exibido já consolida o preço do plano + todos os módulos pagos contratados, e pode incluir um ajuste proporcional (pro-rata) quando o ciclo foi cortado no meio.

Como usar

Pagar via PIX

1. Vá em Faturamento no menu lateral (ícone de cartão).
2. No banner de pagamento pendente ou no card de renovação, clique em Pagar com PIX (ou Renovar com PIX, conforme o caso). O botão é verde, com o logo do PIX.
3. A modal Pagamento via PIX abre exibindo:
   • QR Code para escanear no app do banco.
   • Código copia-e-cola logo abaixo do QR Code.
   • Resumo de valores: linha "Plano {nome}", uma linha por módulo cobrado e o total.
   • Contador regressivo de 30 minutos indicando o prazo do PIX.
4. Pague pelo app do banco. A modal faz polling automático e fecha sozinha quando o pagamento é confirmado. A página recarrega mostrando o plano como Ativo.

Pagar via Cartão de Crédito

1. Vá em Faturamento no menu lateral.
2. No mesmo banner ou card, clique em Pagar com Cartão (ou Renovar com Cartão). O botão é azul, com ícone de cartão.
3. O Viagilize redireciona para o checkout do Mercado Pago. Preencha lá os dados do cartão (número, validade, CVV, nome impresso e CPF do titular).
4. Após confirmar, o Mercado Pago redireciona de volta para /admin/billing com um dos parâmetros:
   • ?status=success - pagamento aprovado.
   • ?status=pending - pagamento em análise.
   • ?status=failure - pagamento recusado.
5. Quando o webhook do Mercado Pago confirmar a aprovação, a assinatura é ativada automaticamente.

Cancelar um pagamento pendente

1. Em Faturamento, localize o pagamento aberto (banner amarelo no topo ou banner laranja de módulo, se for cobrança de módulo).
2. Clique em Cancelar.
3. Confirme no modal. O PIX/checkout fica inválido e a página recarrega. Para o caso de módulo, o módulo volta ao status anterior.

Casos especiais

O valor do PIX mudou depois que eu adicionei um módulo

Se você adiciona ou remove um módulo enquanto há um PIX pendente, o Viagilize detecta a diferença de valor automaticamente: cancela o PIX antigo e gera um novo na próxima abertura da página. Não é preciso cancelar manualmente.

Plano gratuito ou cortesia

Planos com preço R$ 0 e contas marcadas como Cortesia (billing_period = gift) não exibem botão de pagamento - não há nada a cobrar. O selo no topo do card mostra Cortesia ou Ativo.

Assinar plano pago + módulos juntos (saindo do free/trial)

empresas no plano gratuito que querem assinar um plano pago e contratar módulos no mesmo movimento recebem um PIX consolidado com a soma de plano + módulos selecionados. Esse fluxo é disparado pelo modal "Assinar Plano + Módulos" e o pagamento ativa tudo de uma vez quando o webhook confirma.

Assinatura bloqueada

Quando a assinatura vence e não é paga dentro do período de carência (7 dias), você é levado para /admin/billing/blocked. A página de bloqueio também oferece PIX como única forma de retomar o acesso, gerando o valor consolidado de plano + módulos renováveis.

Renovação antecipada

Quando faltam 7 dias ou menos para o fim do período, o card de renovação aparece no topo da página com os botões Renovar com PIX e Renovar com Cartão. O valor já inclui módulos que vão sair do trial junto com o plano, módulos expirados que serão recobrados e o plano em si.

Erros comuns e como resolver

• "Plano gratuito não requer pagamento." - Causa: tentou gerar PIX/checkout estando no plano free. Solução: primeiro troque para um plano pago em Faturamento > Planos Disponíveis e gere o PIX em seguida.
• "Erro ao gerar PIX. Verifique as credenciais." - Causa: o meio de pagamento de pagamento da plataforma está sem credenciais válidas. Solução: abra um ticket no menu Suporte - esse erro é resolvido pelo time Viagilize, não por você.
• "Erro ao gerar PIX. Tente novamente." - Causa: falha temporária no meio de pagamento. Solução: feche a modal e clique em Pagar com PIX de novo. Se persistir por mais de 5 minutos, abra um ticket.
• "Erro ao criar checkout. Tente novamente." - Causa: o checkout do Mercado Pago não respondeu. Solução: tente o PIX como alternativa ou repita o cartão depois de alguns minutos.
• PIX expirou antes de pagar (contador zerou) - Causa: o QR Code tem validade de 30 minutos. Solução: feche a modal e clique em Pagar com PIX novamente para gerar um novo código com o mesmo valor.
• Paguei o PIX mas o plano não ativou - Causa: o webhook do meio de pagamento pode demorar alguns minutos. Solução: aguarde até 5 minutos; se não ativar, recarregue a página. Persistindo, abra um ticket informando o ID do pagamento (visível no banner ou em Faturamento > Ver histórico de pagamentos).

Onde encontrar

• URL: /admin/billing
• Caminho no menu: Faturamento (item fixo no sidebar, com ícone de cartão)
• Permissão necessária: editar os dados da empresa em as configurações
• Módulo necessário: nenhum (é módulo central do Viagilize)
• Histórico completo: /admin/billing/payments

Veja também

• Visão Geral do Faturamento - entender status da assinatura, ciclo de cobrança e próximos vencimentos.
• Trocar de Plano - fluxo de upgrade/downgrade com cálculo proporcional.
• Módulos Adicionais - contratar módulos que entram no PIX/cartão da renovação.
• Carteira de Créditos - usar saldo de afiliados para abater na próxima cobrança.