ConfirmarPix — Manual do Usuário (web)
Guia completo de todas as funcionalidades da plataforma web de pagamentos Pix com conciliação automática, agenda, fiscal, CRM e configurações avançadas.
24 funcionalidades 31 controllers de API Notificações via WhatsApp, SMS e Email
Fiscal NF-e / NFC-e / NFS-e
📊 Dashboard
💸 Expectativas
🔄 Transações
🧾 Cobranças
🔗 Conciliação
📄 Extrato
📅 Agenda
🔁 Recorrências
📜 NF-e / NFC-e
🏷 NFS-e
👤 Clientes
📈 CRM
📊 Relatórios
🔮 Projeções
👥 Equipe
⚙️ Config
Acesso ao sistema
Login
- Acesse o endereço da plataforma no navegador.
- Informe seu e-mail e senha e clique em Entrar.
- Se você ativou a autenticação em dois fatores (2FA), informe o código do aplicativo autenticador (Google Authenticator / Authy).
- Você será redirecionado ao Dashboard.
Dica: Esqueceu a senha? Use o link Esqueci minha senha na tela de login. Um e-mail com link de redefinição será enviado em instantes.
Primeiro acesso (novo cadastro)
- Clique em Criar conta e preencha seus dados (nome, e-mail, senha, nome da empresa).
- Confirme seu e-mail pelo link enviado para sua caixa de entrada.
- Sua conta começa no plano Trial gratuito com todas as funcionalidades liberadas por tempo limitado.
Convite de equipe
Se você foi convidado, verifique seu e-mail, clique em Aceitar convite e defina sua senha. Você será adicionado automaticamente a empresa como membro.
Autenticação 2FA
Va em Configurações → Segurança → Ativar 2FA. Escaneie o QR code com seu autenticador e confirme com o código de 6 dígitos. Salve os 8 códigos de recuperação em local seguro.
Interface e navegação
Sidebar de navegação
A barra lateral esquerda organiza todas as seções. Clique no ícone de menu para recolher e ganhar mais espaço de tela. As seções com cadeado são exclusivas para usuários com role owner.
Perfil e logout
No canto superior direito você encontra: seu avatar com nome, badge de role e botão de logout.
Roles de acesso
| Role | O que pode fazer |
|---|---|
| owner | Acesso total: todas as funções + equipe, auditoria, assinatura e branding |
| receptionist | Cadastrar expectativas, agenda, clientes e conciliação manual |
| viewer | Somente visualização de relatórios, pagamentos e clientes |
| reseller | Revendedor white-label: gerencia clientes e branding próprio |
Dashboard
Visão geral do negócio em tempo real — O Dashboard exibe os indicadores do dia e do mês corrente, permitindo uma rápida leitura da saúde financeira da operação.
💰
Recebido hoje
Total de Pix confirmados no dia atual.
⏳
Aguardando
Expectativas do dia ainda não pagas.
⚠️
Divergentes
Pagamentos com valor diferente do esperado.
📈
Receita do mês
Acumulado de pagamentos confirmados no mês.
O Dashboard também exibe uma listagem das expectativas de hoje com status em tempo real e atalhos rápidos para as ações mais frequentes.
Expectativas de Pagamento
Cadastro e acompanhamento de cobranças esperadas — Aqui você registra o que espera receber: cliente, valor, serviço e data prevista. O sistema monitora automaticamente se o Pix chegou.
Criar expectativa
- Clique em Nova expectativa.
- Preencha: nome do cliente, valor (R$), serviço/descrição e data prevista.
- Opcionalmente vincule a um cliente cadastrado para habilitar o portal de autoatendimento.
- Clique em Salvar. O sistema gera automaticamente uma cobrança Pix no gateway configurado.
- Compartilhe o link de pagamento ou copie o QR code para enviar ao cliente.
Status das expectativas
| Status | Significado |
|---|---|
| Pago | Pix recebido e conciliado com sucesso |
| Aguardando | Ainda não foi pago |
| Divergente | Pix recebido, mas valor diferente do esperado |
| Cancelado | Expectativa cancelada manualmente |
| Expirado | Prazo vencido sem pagamento |
Ações disponíveis
- Editar - altera nome, valor, serviço, data
- Cancelar - cancela no sistema e no gateway
- Enviar link - envia QR code/link por WhatsApp ou e-mail
- Ver QR code - copia o código Pix copia e cola
Filtros e busca
Use os filtros no topo: status, data de vencimento, nome/serviço. A busca textual pesquisa em nome do cliente, serviço e notas. Resultados paginados com 20 por página.
Atenção: Criar novas expectativas é bloqueado quando a assinatura está vencida. Você ainda pode visualizar, mas não criar.
Transações Pix
Todos os Pix recebidos em tempo real — Lista completa de transações recebidas via webhook dos gateways (Asaas e Efi). Exibe pagador, valor, hora de recebimento e status de conciliação.
| Campo | Descrição |
|---|---|
| Data/hora | Momento exato em que o Pix foi recebido |
| Pagador | Nome e CPF/CNPJ de quem efetuou o Pix |
| Valor (R$) | Valor exato recebido |
| EndToEndId | Identificador único do Banco Central |
| Gateway | Asaas, Efi ou Mercado Pago |
| Conciliação | conciliado ou pendente |
Filtros disponíveis: data inicial / data final, busca por nome ou EndToEndId. Transações não conciliadas aparecem destacadas para ação rápida.
Cobranças
Cobranças geradas nos gateways de pagamento — Aqui você visualiza as cobranças Pix que foram efetivamente criadas nos PSPs (Asaas ou Efi), com seus respectivos status e QR codes.
Cada cobrança exibe: QR code, código copia-e-cola, data de vencimento, valor, status no PSP e vínculo com a expectativa de origem.
Status de cobrança
| Status | Significado |
|---|---|
| RECEIVED | Pix pago com sucesso |
| PENDING | Aguardando pagamento |
| OVERDUE | Vencida sem pagamento |
| REFUNDED | Devolvida ao pagador |
Cancelar cobrança
- Localize a cobrança na lista.
- Clique nos três pontos e selecione Cancelar.
- Confirme. O cancelamento e enviado para o PSP imediatamente.
Dica: Cancelar uma cobrança não cancela a expectativa. Para cancelar completamente, use a tela de Expectativas.
Conciliação
Reconciliação automática e manual de pagamentos — O sistema cruza automaticamente os Pix recebidos com as expectativas cadastradas. Quando o match é incerto, você pode confirmar ou corrigir manualmente.
Conciliação automática
O engine de reconciliação analisa automaticamente cada Pix recebido contra as expectativas pendentes usando:
- Similaridade do nome do pagador
- Valor exato ou próximo
- Janela de datas (agendado +/- tolerância)
- CPF/CNPJ do pagador quando disponível
Conciliação manual
- Acesse a aba Transações pendentes - Pix sem match automático.
- Clique em Sugestões para ver as expectativas mais prováveis.
- Confirme o match correto ou busque outra expectativa.
Tipos de match
| Tipo | Origem |
|---|---|
| automático | Engine reconciliou sem intervenção |
| sugerido | Engine sugeriu, usuário confirmou |
| manual | Usuário escolheu explicitamente |
Importar Extrato Bancário
Reconciliar pagamentos via CSV ou OFX — Importe o extrato do seu banco para conciliar Pix recebidos que não passaram pelo webhook do gateway.
- Exporte o extrato do seu banco em formato CSV ou OFX.
- Clique em Importar extrato e selecione o arquivo (máximo 5 MB).
- O sistema processa as entradas e exibe um resumo: total de linhas, duplicatas ignoradas, conciliadas automaticamente.
- Revise as entradas que ficaram pendentes e faça conciliação manual se necessário.
O histórico de todos os imports fica disponível com data, arquivo e estatísticas de cada importação.
Agenda
Gerenciamento de agendamentos com cobrança automática — Agende atendimentos, procedimentos ou reuniões com seus clientes. O sistema pode gerar automaticamente uma expectativa de cobrança no momento do agendamento.
Criar agendamento
- Clique em Novo agendamento.
- Informe: nome do cliente, serviço, data e hora, duração e valor.
- Ative Gerar cobrança automaticamente para criar uma expectativa Pix junto com o agendamento.
- Salve. O cliente pode receber notificação automática se configurada.
Status do agendamento
| Status | Quando usar |
|---|---|
| Agendado | Recém criado |
| Confirmado | Cliente confirmou presença |
| Realizado | Atendimento aconteceu |
| Cancelado | Cancelado por qualquer parte |
| Faltou | Cliente não compareceu (no-show) |
Alterne entre vista de lista e calendário mensal. Filtre por status e por intervalo de datas.
Planos Recorrentes
Cobranças automáticas periódicas — Crie planos de cobrança recorrente (mensalidades, planos, assinaturas) e o sistema gera as expectativas automaticamente na data programada.
Criar plano recorrente
- Acesse Recorrências → Nova recorrência.
- Informe: cliente, serviço, valor, data de início e frequência.
- Escolha a frequência: Semanal, Quinzenal, Mensal ou Anual.
- Salve. O plano passa a gerar expectativas automaticamente no prazo configurado.
Gestão de planos
Na listagem você ve: próxima geração (nextRunAt), última geração, cliente e status. Você pode pausar (desativar) ou cancelar o plano a qualquer momento.
Dica: Planos recorrentes são processados automaticamente todo dia por um job em background. Você não precisa fazer nada - as expectativas aparecem automaticamente.
Frequências disponíveis
| Frequência | Descrição |
|---|---|
| Semanal | A cada 7 dias |
| Quinzenal | A cada 14 dias |
| Mensal | Mesma data todo mês |
| Anual | Uma vez por ano |
Scanner QR Code
Confirmação de pagamento via câmera — Para ambientes de atendimento presencial: leia o QR code do comprovante Pix do cliente com a câmera do computador e confirme o pagamento instantaneamente.
- Acesse Scanner no menu lateral.
- Permita o acesso à câmera quando o navegador solicitar.
- Aponte a câmera para o QR code do comprovante Pix exibido pelo cliente.
- O sistema lê o EndToEndId do comprovante e busca automaticamente a transação correspondente.
- Se a transação for encontrada, exibe a confirmação de pagamento com nome do pagador, valor e hora.
Portal do Cliente
Autoatendimento do cliente via magic link — Cada cliente pode receber um link seguro e temporário para visualizar suas cobranças, pagar pendências e baixar comprovantes sem precisar criar uma conta.
Gerar link do portal
- Va em Clientes → selecione o cliente → Portal.
- Clique em Gerar link de acesso. O link expira após o período configurado.
- Copie o link ou envie diretamente por WhatsApp ou e-mail.
O que o cliente ve no portal
- Lista de cobranças em aberto (com QR code)
- Histórico de pagamentos realizados
- Status atualizado em tempo real
- Comprovantes para download
Dica: O portal usa um token de sessão seguro com expiração. Cada link funciona apenas por sessão - sem senha necessária.
Notas Fiscais (NF-e / NFC-e)
Emissão de NF-e Modelo 55 e NFC-e Modelo 65 integradas à SEFAZ — Módulo fiscal completo com certificado digital A1, validação XSD, assinatura XML, transmissão SEFAZ e geração de DANFE em PDF.
Configuração inicial (obrigatória)
- Configuração fiscal: vá em NF-e → Configuração. Preencha: regime tributário, CNPJ, endereço completo, ambiente (homologação ou produção) e CSC para NFC-e.
- Certificado digital A1: vá em NF-e → Certificados → Adicionar. Faça upload do arquivo .pfx e informe a senha. O certificado e armazenado criptografado com AES-256-GCM.
- Produtos: cadastre os produtos/serviços em NF-e → Produtos com NCM, CFOP, unidade de medida e preço padrão.
- Clientes fiscais: cadastre os destinatários em NF-e → Clientes com CNPJ/CPF, IE e endereço completo.
Emitir uma NF-e
- Clique em Nova nota.
- Selecione o modelo: 55 - NF-e ou 65 - NFC-e.
- Adicione o destinatário e os itens (produto, quantidade, valor, impostos).
- Clique em Transmitir. O sistema assina, valida e envia para a SEFAZ.
- Após autorização, baixe o XML assinado e o DANFE em PDF.
Status das notas
| Status | Significado |
|---|---|
| Rascunho | Ainda não transmitida |
| Transmitindo | Aguardando retorno da SEFAZ |
| Autorizada | SEFAZ autorizou (protocolo emitido) |
| Rejeitada | SEFAZ rejeitou - veja o erro |
| Cancelada | Cancelada pelo emitente |
| Contingência | SEFAZ indisponível - emitida em contingência |
Modo contingência
Quando a SEFAZ está indisponível, ative o modo contingência em NF-e → Contingência com a justificativa obrigatória. As notas são emitidas localmente e transmitidas quando o serviço voltar.
NFS-e (Nota Fiscal de Serviços)
Emissão de NFS-e para expectativas de pagamento — Vincule notas de serviço diretamente às expectativas pagas, com emissão automática configurável e consulta de status.
Emitir NFS-e manualmente
- Acesse NFS-e no menu.
- Localize a expectativa paga e clique em Emitir nota.
- O sistema envia para a prefeitura e aguarda a autorização.
- Após emissão, a nota fica disponível para download.
Emissão automática
Ative em NFS-e → Configurações → Emitir automaticamente. Toda vez que uma expectativa for marcada como paga, a NFS-e será emitida automaticamente.
Ações disponíveis
- Retentar - para notas com erro
- Cancelar - cancela na prefeitura
- Baixar XML/PDF - quando autorizada
Cadastro de Clientes
Gestão completa da base de clientes — Cadastre e organize seus clientes com dados de contato, documentos, histórico de pagamentos e tags para segmentação.
Cadastrar cliente
- Clique em Novo cliente.
- Preencha: nome, CPF/CNPJ (opcional), e-mail, telefone.
- Adicione tags para categorização (ex: premium, inadimplente, mensal).
- Salve. O cliente agora pode ser vinculado a expectativas e agendamentos.
Ficha do cliente
Clique em um cliente para ver sua ficha completa:
- Dados cadastrais - nome, doc, contato, endereço
- Histórico de pagamentos - todas as expectativas e status
- Tags - adicionar e remover livremente
- Notas internas - comentários da equipe
- Portal do cliente - gerar magic link
Busca e filtros
Filtre por nome, CPF/CNPJ, e-mail ou tags. A busca é case-insensitive e retorna resultados paginados.
CRM e Campanhas
Inteligência de clientes e campanhas de comunicação em massa — Análise o comportamento da base de clientes, identifique inativos e dispare campanhas por WhatsApp, SMS ou e-mail para segmentos específicos.
Visão geral do CRM
O painel CRM exibe:
- Total de clientes ativos
- Clientes inativos (sem pagamento em X dias)
- LTV (lifetime value) total da base
- Todas as tags e quantidades por tag
Filtros avançados
Combine filtros para criar segmentos: tag, dias sem atividade, LTV mínimo, status de pagamento recente.
Disparar campanha
- Selecione o segmento (todos, por tag, por inatividade).
- Escolha o canal: WhatsApp, SMS ou E-mail.
- Escreva a mensagem personalizada.
- Clique em Disparar campanha. O sistema envia em paralelo para todos os destinatários.
Atenção: Campanhas são exclusivas para usuários com role owner. Confirme antes de disparar - não ha desfazer.
Relatórios Financeiros
Análise de receita com drill-down por período e serviço — Visualize o desempenho financeiro com gráficos, resumos por serviço e comparativos entre períodos.
Filtros disponíveis
| Filtro | Opções |
|---|---|
| Período | Última semana, últimas 4 semanas, último mês, 3 meses, 6 meses, personalizado |
| Granularidade | Por dia, por semana, por mês |
| Breakdown | Por serviço - distribuição da receita por tipo |
Métricas no relatório
- Receita total no período
- Número de pagamentos
- Ticket medio
- Taxa de inadimplência (vencidos / total)
- Gráfico temporal (barras ou linhas)
- Top serviços por receita
Projeções de Receita
Previsão de receita baseada em histórico e recorrências — Visualize o forecast de receita das próximas semanas com base em planos recorrentes ativos e padrão histórico de pagamentos.
O painel de projeções exibe uma linha do tempo com:
📅
Próximas semanas
Cobranças agendadas de planos recorrentes e expectativas futuras já criadas.
📈
Histórico
Receita realizada das últimas semanas para comparação e tendência.
🔮
Projeção
Estimativa de receita baseada em conversão histórica dos planos ativos.
Gestão de Equipe (somente owner)
Convidar e gerenciar membros da equipe — Adicione membros da equipe com roles específicas para controlar o acesso às funcionalidades da plataforma.
Convidar membro
- Acesse Equipe → Convidar.
- Informe: nome, e-mail e role desejada.
- O convidado recebe um e-mail com link de ativação. Você pode reenviar o convite se necessário.
Gerenciar membros
- Alterar role - promover ou rebaixar acesso
- Desativar - revoga acesso sem remover da equipe
- Reativar - restaura acesso de membro inativo
Roles detalhadas
| Role | Permissões |
|---|---|
| owner | Tudo: inclui equipe, billing, branding, CRM campaigns, auditoria |
| receptionist | Criar expectativas, agenda, clientes, conciliação manual, NF-e |
| viewer | Somente leitura em todas as telas |
| reseller | White-label: gerencia clientes + branding mas não acessa financeiro |
Auditoria (somente owner)
Histórico completo de ações da equipe — Rastreie todas as ações realizadas na plataforma por cada usuário - quem fez o que e quando.
Cada entrada de auditoria registra:
Ação
O que foi feito (criou, editou, cancelou, logou...)
Entidade
Qual objeto foi afetado (expectativa, cliente, usuário...)
Usuário
Quem executou a ação (e-mail + role)
Data/hora
Timestamp UTC da ação
Filtros de auditoria
Filtre por: ação (login, create, update, delete, cancel...), entidade, usuário específico, período (data inicial e final). Resultados paginados.
Assinatura (somente owner)
Gestão do plano e assinatura da plataforma — Visualize seu plano atual, uso do mês, histórico de faturamento e faça upgrade, downgrade ou cancelamento.
Planos disponíveis
| Plano | Recursos |
|---|---|
| Trial | Todas as funções por tempo limitado. Sem cartão. |
| Essencial | Pagamentos, conciliação, NFS-e, agenda, CRM básico |
| Pro | Tudo + NF-e/NFC-e, branding white-label, relatórios avançados |
Ações disponíveis
- Trocar plano - upgrade/downgrade com efeito imediato
- Cancelar - acesso mantido até o fim do ciclo
- Reativar - reativa plano cancelado
O painel exibe: uso de Pix no mês, data de renovação, status da assinatura e alertas de bloqueio.
Marca e Branding (somente owner)
Personalização white-label da plataforma — Customize a plataforma com sua marca - logo, cor, nome e domínio personalizado para vender como produto próprio.
Campos de branding
| Campo | Descrição |
|---|---|
| Nome da marca | Substitui "ConfirmarPix" na interface |
| Logo URL | URL da imagem de logo (recomendado 200x50px) |
| Cor primária | Cor HEX do tema (ex: #6366f1) |
| Telefone de suporte | Exibido para clientes finais |
| Domínio customizado | Subdomínio próprio (ex: pay.suaempresa.com) |
Temas da interface
Independente do branding, cada usuário pode personalizar a interface:
- Dark / Light mode - alterne no ícone de lua/sol no topo
- Paleta de cores: Indigo (padrão), Teal ou Rose
- Densidade: Confortável ou Compacta
As preferências são salvas automaticamente por usuário.
Configurações
Configurações gerais da conta e integrações — Tudo em um lugar: canais de notificação, gateway de pagamento, configurações de lembretes e segurança.
Canais de notificação
Configure como seus clientes recebem confirmações de pagamento:
| Canal | Campo | Exemplo |
|---|---|---|
| Número (com DDD) | 5511999999999 | |
| SMS | Número SMS | +5511988887777 |
| E-mail de notificação | contato@empresa.com |
Dica: Você pode configurar múltiplos canais simultaneamente. As mensagens são disparadas em paralelo para todos os canais ativos.
Lembretes e alertas automáticos
| Config | Descrição |
|---|---|
| Enviar lembretes | Notifica clientes X dias antes do vencimento |
| Dias antes | Ex.: 1, 2 ou 3 dias antes |
| Alertas de inadimplência | Notifica após X dias sem pagamento |
| Expirar após | Expectativas expiram automaticamente após X dias |
Gateway de pagamento
Configure as credenciais de API do Asaas ou Efi. Defina qual é o gateway primário - o outro e usado como fallback automático em caso de falha.
ConfirmarPix - Manual do Usuário Web - 24 funcionalidades