Pagamento
O pagamento da assinatura é feito pelo modal de checkout que abre a partir da tela Financeiro. O fluxo é em três etapas (stepper) e aceita múltiplos métodos.
Formas de acionar o checkout
| Origem | Como chegar ao checkout |
|---|---|
| Botão "Pagamento Antecipado" | Tela Financeiro > card Meu Plano > botão azul na parte inferior |
| Botão "Pagar agora" | Banner vermelho de conta expirada (aparece quando o dueDate passou) |
| Botão "Pagar" na tabela de faturas | Qualquer fatura com status "Em aberto" ou "Vencida" |
| Troca de plano | Após clicar em "Trocar de plano" na seção Planos Disponíveis |
Fluxo de checkout (3 etapas)
Etapa 1 — Dados (pulada automaticamente)
Campos de endereço (nome, endereço, cidade, estado, CEP, país). Na prática, o checkout inicia na Etapa 2 — os campos de nome e CPF/CNPJ são preenchidos com os dados da sua empresa e editáveis na Etapa 3 (Revisão).
Etapa 2 — Personalizar (escolha do plano)
Exibe um card com o plano atual da sua empresa: nome, valor mensal, limites de usuários, conexões e filas.
- Clique em Selecionar para confirmar o plano e avançar para a revisão.

Etapa 3 — Revisão
Tela final antes do pagamento. Contém:
- Campo Nome completo — preenchido com o nome da empresa; editável caso esteja em branco ou incorreto.
- Campo CPF / CNPJ — preenchido com o documento cadastrado; editável. Formato automático (CPF: 000.000.000-00 / CNPJ: 00.000.000/0000-00).
- Resumo do plano selecionado com valor total.
Validação obrigatória
O botão Pagar só é habilitado quando:
- O campo Nome tiver pelo menos 2 caracteres.
- O CPF ou CNPJ for válido (validação completa com dígitos verificadores).

Tela de pagamento (após confirmar)
Ao clicar em Pagar, o sistema processa a requisição (POST /subscription) e exibe a tela de confirmação com as opções de pagamento disponíveis para sua empresa.
Métodos suportados
| Método | Quando aparece |
|---|---|
| Pix | Quando a fatura tem QR Code Pix gerado — exibe o QR Code e botão "Copiar código Pix" |
| Cartão de crédito (Stripe) | Quando a fatura tem URL Stripe configurada |
| Mercado Pago | Quando a fatura tem URL Mercado Pago configurada |
| Asaas | Quando a fatura tem URL Asaas configurada |
Os métodos disponíveis dependem de como a plataforma está configurada. Podem aparecer um ou mais métodos simultaneamente.

Pagamento via Pix
- Escaneie o QR Code com o aplicativo do seu banco, ou
- Clique em Copiar código Pix para copiar o código copia-e-cola.
- Cole no seu banco e confirme o pagamento.
- O sistema detecta a confirmação em tempo real (via WebSocket) e exibe o toast "Licença renovada até DD/MM/AAAA!".
- Após 4 segundos, você é redirecionado automaticamente para o Dashboard.
Pagamento via cartão / Mercado Pago / Asaas
- Clique no botão correspondente.
- Uma nova aba abre com a página de pagamento do provedor.
- Conclua o pagamento no provedor externo.
- O sistema atualiza seu acesso automaticamente após a confirmação do provedor (via webhook).
Confirmação de pagamento
Quando o pagamento é confirmado (qualquer método), o sistema:
- Atualiza o
dueDateda empresa. - Emite evento WebSocket
company-{id}-paymentcomaction: "CONCLUIDA". - Exibe toast de sucesso com a nova data de vencimento.
- Redireciona para o Dashboard após 4 segundos.
Problemas comuns
"O botão 'Pagar' está desabilitado." Verifique se o Nome (mínimo 2 caracteres) e o CPF/CNPJ estão preenchidos e válidos na Etapa 3. O botão só habilita com ambos os campos válidos.
"Gerei o Pix mas não fui redirecionado após pagar." A confirmação é em tempo real via WebSocket. Se a conexão cair, recarregue a tela Financeiro — o status da fatura deve aparecer como "Pago" na tabela.
"O modal de checkout não abre." Pode haver um problema de JavaScript na página. Tente recarregar e repetir. Se persistir, limpe o cache do navegador.
"Paguei mas o acesso ainda está bloqueado." Aguarde até 5 minutos para o webhook do provedor processar. Se o status na tabela de faturas ainda aparecer como "Em aberto", acione o suporte com o comprovante de pagamento.
