Skip to content

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

OrigemComo 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 faturasQualquer fatura com status "Em aberto" ou "Vencida"
Troca de planoApó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.

Card do plano na etapa Personalizar

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 revisão do checkout

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étodoQuando aparece
PixQuando 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 PagoQuando a fatura tem URL Mercado Pago configurada
AsaasQuando 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.

Tela de confirmação com opções de pagamento

Pagamento via Pix

  1. Escaneie o QR Code com o aplicativo do seu banco, ou
  2. Clique em Copiar código Pix para copiar o código copia-e-cola.
  3. Cole no seu banco e confirme o pagamento.
  4. O sistema detecta a confirmação em tempo real (via WebSocket) e exibe o toast "Licença renovada até DD/MM/AAAA!".
  5. Após 4 segundos, você é redirecionado automaticamente para o Dashboard.

Pagamento via cartão / Mercado Pago / Asaas

  1. Clique no botão correspondente.
  2. Uma nova aba abre com a página de pagamento do provedor.
  3. Conclua o pagamento no provedor externo.
  4. 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:

  1. Atualiza o dueDate da empresa.
  2. Emite evento WebSocket company-{id}-payment com action: "CONCLUIDA".
  3. Exibe toast de sucesso com a nova data de vencimento.
  4. 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.