Guia de instalação

1 Requisitos

2 Enviar os arquivos

1. Descompacte o arquivo antifraudebr.zip no seu computador.
2. Envie a pasta modules/addons/antifraudebr para a raiz da instalação do WHMCS, mantendo o mesmo caminho. O resultado deve ser:

   /caminho/do/whmcs/modules/addons/antifraudebr/antifraudebr.php

3. A pasta docs/ do zip contém estes guias — não precisa enviá-la para o servidor.

3 Ativar o addon

1. No admin do WHMCS, acesse Configurações (engrenagem) → Módulos Addon.
2. Localize Antifraude BR e clique em Ativar. As tabelas do módulo são criadas nesse momento.
3. Clique em Configurar:
   • em Controle de Acesso, marque os grupos de administradores que poderão usar o módulo (o grupo “Administrador Completo”, no mínimo);
   • preencha o campo de CPF/CNPJ (próximo passo) e clique em Salvar alterações.
4. O menu Addons → Antifraude BR passa a aparecer no admin.

4 Campo de CPF/CNPJ

O módulo lê o documento de campos personalizados de cliente (Configurações → Campos Personalizados de Cliente) — o mesmo campo que os seus módulos de cobrança usam. Escolha um dos modos:

A escolha fica em Configurar (tela do addon) ou em Antifraude BR → Configurações → Origem do CPF/CNPJ.

5 Licença

1. Abra Addons → Antifraude BR → aba Licença.
2. Cole a chave de licença recebida na compra e clique em Salvar e validar.
3. A situação deve aparecer como Ativa.

6 Permissões de arquivos

No Dashboard do módulo, clique em Setar Permissões (abre em outra aba). A página mostra:

• se a pasta storage/ pode ser gravada pelo PHP (necessário para baixar a base de localização GeoLite2);
• se as proteções .htaccess de storage/, lib/ e templates/ estão no lugar;
• arquivos com permissão diferente da recomendada (pastas 755, arquivos 644).

Clique em Aplicar permissões recomendadas para corrigir tudo de uma vez. Só a pasta do módulo é alterada.

7 Integrações (opcionais)

Todas ficam em Antifraude BR → Integrações, cada uma com um passo a passo na própria tela. O módulo funciona sem elas — só as verificações que dependem de cada uma ficam de fora.

8 Modo somente observar

O módulo é instalado com o modo somente observar ligado: tudo é analisado e registrado, mas nenhum pedido é bloqueado ou retido.

1. Deixe assim por uma ou duas semanas.
2. Acompanhe o Dashboard, o Histórico e a aba Relatórios — veja o que “teria sido” recusado ou revisado.
3. Ajuste pesos e faixas em Regras e Pesos se necessário.
4. Desligue em Configurações → Modo somente observar.

9 Servidor com Nginx

Os arquivos .htaccess protegem as pastas internas no Apache e no LiteSpeed. No Nginx, acrescente ao bloco do site:

location ~ ^/modules/addons/antifraudebr/(lib|storage|templates)/ {
    deny all;
    return 404;
}

10 Checklist final

• Addon ativado e grupos de administradores marcados em Controle de Acesso.
• Campo de CPF/CNPJ configurado (o aviso amarelo no topo do painel some).
• Licença Ativa.
• Setar Permissões mostrando “Tudo certo”.
• Cron do WHMCS rodando (as listas públicas mostram a data da última sincronização).
• Integrações desejadas configuradas.
• Um pedido de teste aparece no Histórico.

11 Atualizar e desinstalar

Atualizar

1. Envie a nova pasta modules/addons/antifraudebr por cima da atual.
2. Abra o painel do módulo uma vez — tabelas e colunas novas são criadas automaticamente. Suas regras, listas e configurações são mantidas.

Desinstalar

Em Configurações → Módulos Addon → Antifraude BR → Desativar. Os dados ficam guardados, a menos que a opção Remover dados ao desativar esteja marcada na configuração do addon.

12 Problemas comuns