Guia de utilização

1 Como o módulo decide

O Antifraude BR age em dois momentos:

• Cadastro e edição de dados (área do cliente): só confere se os dados estão certos — CPF/CNPJ, e-mail, CEP e telefone. Dado errado mostra um erro e o cliente corrige. Não há pontuação aqui.
• Finalização do pedido: roda todas as regras, soma os pesos das que dispararam e chega a um score de 0 a 100.

• Uma regra com peso 100 (ex.: Documento inválido, Lista negra) recusa na hora, sem olhar o resto.
• As faixas podem ser alteradas em Regras e Pesos, inclusive por grupo de produto.
• Cliente na lista branca é aprovado direto. Clientes isentos (por ID, grupo de produto, pedido de valor zero ou número de faturas pagas) não são analisados.
• No modo somente observar, tudo é analisado e registrado, mas nada é bloqueado nem retido.
• Uma fonte externa fora do ar nunca trava o checkout: a regra que dependia dela é simplesmente pulada.

2 O que o cliente vê

• No cadastro: mensagens comuns de validação (“O CPF informado é inválido…”, “E-mails temporários não são aceitos…”).
• Pedido recusado: apenas a mensagem que você configurou (padrão: “Não foi possível concluir seu pedido no momento…”). O motivo nunca é mostrado.
• Pedido em revisão: nada diferente — a não ser que a confirmação pelo WhatsApp esteja ligada Requer o addon Notifica Zapi.
• O cliente nunca recebe e-mail ou mensagem com as palavras “antifraude”, “score” ou “regra”.

3 Dashboard

• Indicadores do período (7, 30 ou 90 dias): aprovadas, revisão, recusadas e o valor barrado. Análises em modo observar aparecem à parte (“teriam sido recusadas”).
• Gráfico diário e a opção “Ver como tabela”.
• Regras que mais disparam — clique para ver o histórico filtrado por elas.
• Status das fontes e o consumo das APIs no dia.
• Botões Setar Permissões e Ver Logs, que abrem em outra aba (veja a seção 13).

4 Fila de Revisão

Aqui ficam os pedidos que caíram na faixa de revisão. Cada item mostra o cliente, o pedido, o score, as regras disparadas (com o motivo) e, se houver, a situação da confirmação pelo WhatsApp Requer o addon Notifica Zapi.

Toda ação pede confirmação e fica registrada no histórico e nas notas do cliente.

5 Histórico

• Filtros por período, decisão, cliente/pedido, score mínimo, regra e origem (cadastro, checkout, pedido, manual).
• Clique no número da análise para ver o detalhe: a barra “Como o score foi calculado” (quanto cada regra somou e onde ficam as faixas), as regras com o motivo, as fontes consultadas, o dispositivo usado e o resultado da revisão.
• Analisar cliente agora: roda as regras com os dados atuais de um cliente. Cliente já analisado não é analisado de novo — a análise existente é aberta.

6 Relatórios

Escolha o mês (últimos 12). O relatório mostra análises e a variação em relação ao mês anterior, aprovadas, revisão, recusadas e o valor barrado, o tempo médio de revisão, as regras que mais dispararam, as revisões feitas, as confirmações pelo WhatsApp (com o addon Notifica Zapi) e o aprendizado com fraudes confirmadas.

O relatório do mês anterior também chega por e-mail no dia 1º (pode ser desligado em Configurações).

7 Regras e Pesos

Cada regra pode ser ligada/desligada e ter o peso ajustado (de −100 a 100). Algumas têm parâmetros (dias, quantidade de pedidos, distância…). Restaurar padrões volta tudo aos valores de fábrica.

8 Listas

Lista negra

Recusa na hora (peso 100). Um item entra quando:

• a equipe adiciona manualmente (CPF/CNPJ, e-mail, domínio, IP, faixa de IP ou telefone — com validade opcional) ou importa um CSV;
• a equipe usa Recusar e bloquear na Fila de Revisão;
• a equipe marca um pedido como Fraude no WHMCS (aprendizado — pode ser desligado).

Recusas automáticas do módulo nunca colocam ninguém na lista negra.

Lista branca

Aprova direto, sem score. Só entra o que a equipe adicionar manualmente ou importar.

Domínios descartáveis

Além da lista pública (atualizada sozinha), você pode adicionar domínios próprios. Em Integrações → Listas públicas, o botão Ver lista mostra os IPs Tor e os domínios descartáveis baixados.

Itens saem pela lixeira (com confirmação) ou sozinhos quando vence a validade.

9 Integrações

• proxycheck.io — VPN, proxy e datacenter. Mostra o consumo da cota diária e alerta ao passar de 80%.
• MaxMind GeoLite2 — localização do IP; a base é atualizada toda semana.
• WhatsApp Requer o addon Notifica Zapi — conexão por QR Code, mensagem de teste e números da equipe para alertas.
• Listas públicas — IPs Tor e e-mails descartáveis, com Sincronizar e Ver lista.

Cada integração é opcional e tem o passo a passo na própria tela.

10 Configurações

11 Confirmação pelo WhatsApp

Com a opção ligada (e o WhatsApp conectado), um pedido em revisão pode ser liberado pelo próprio cliente:

1. Na página de pedido concluído e no painel da área do cliente aparece “Falta só uma confirmação rápida”. Opcionalmente, o link também vai pelo WhatsApp.
2. O cliente pede o código e recebe uma mensagem em nome da sua empresa com 6 dígitos (válido por 15 minutos).
3. Ao digitar o código, o pedido é aprovado automaticamente — ou fica marcado como confirmado para você aprovar, conforme a configuração.

Limites de segurança: 5 tentativas, 3 envios por pedido e 60 segundos entre envios. O número usado é o do cadastro no momento do pedido. A confirmação não é oferecida quando o próprio telefone é suspeito, há lista negra ou vínculo com fraude anterior.

12 Perfil do cliente e tela do pedido

No resumo do cliente (admin do WHMCS) aparece o painel do Antifraude BR:

• a situação atual (lista negra, lista branca, aprovado na revisão, em revisão…);
• a última análise, a contagem de análises e o que está aguardando revisão;
• Contas ligadas: outras contas que compartilham CPF/CNPJ, telefone ou dispositivo, com link para cada uma;
• os botões Ver histórico e Analisar agora (só para cliente ainda não analisado).

Na tela do pedido, o painel mostra a decisão, o score e as regras de maior peso. As Notas do cliente registram automaticamente pedidos retidos/recusados e o resultado de cada revisão.

13 Ver Logs e Setar Permissões

Ver Logs

Registro do que o módulo fez e dos erros que encontrou. Filtre por nível (erro, aviso, info), período e texto; abra Detalhes para ver o contexto. Remova os registros selecionados ou todos os do filtro. Registros com mais de 90 dias são apagados automaticamente pelo cron.

Setar Permissões

Confere as permissões de arquivos do módulo (pastas 755, arquivos 644, storage/ gravável e proteções .htaccess) e corrige tudo com Aplicar permissões recomendadas.

As duas páginas abrem em outra aba e só para administradores com acesso ao módulo.

14 Tarefas automáticas

O módulo usa o cron do próprio WHMCS:

Sem o cron, a análise de pedidos continua funcionando — só listas, alertas e relatórios ficam parados.

15 LGPD e privacidade

• Base legal: prevenção à fraude e legítimo interesse (LGPD, art. 7º, IX, e art. 11, II, “g”).
• CPF/CNPJ, telefone e identificadores do dispositivo são guardados apenas como hash e exibidos mascarados.
• Ao excluir um cliente no WHMCS, as análises dele são anonimizadas.
• As análises são apagadas após o prazo de retenção configurado (padrão: 365 dias); os logs, após 90 dias.

16 Perguntas frequentes

Um cliente legítimo foi recusado. O que faço?

Abra a análise no Histórico e veja na barra “Como o score foi calculado” qual regra pesou. Se for um caso comum no seu público, reduza o peso dessa regra. Se o cliente estiver na lista negra por engano, remova-o em Listas.

Vendo para clientes de fora do Brasil. Funciona?

Sim. Para cadastros fora do Brasil, o campo de CPF/CNPJ é ignorado e as regras de CEP, estado e fuso não se aplicam. VPN, e-mail, listas e demais verificações continuam valendo.

O módulo funciona sem proxycheck.io ou MaxMind?

Sim. Sem eles, só as verificações de VPN/proxy e de localização do IP ficam de fora — e isso não manda ninguém para revisão.

Como sei se algo deu errado?

Use Ver Logs no Dashboard, filtrando por Erro.