Como funciona a Análise de Risco (antifraude)
Atualizado em 22/10/2026
A análise de risco é a camada antifraude da loja. Ela envia os pedidos pagos no cartão de crédito para um serviço especializado, a ClearSale ou a Konduto, que avalia a chance de fraude e devolve uma decisão. É essa decisão que captura (efetiva a cobrança) ou cancela o pagamento no gateway, sem que você precise conferir pedido por pedido.
A listagem fica em Pagamentos > Análise de Risco, e as configurações no botão Ajustes dessa listagem.
Regra: a loja usa um serviço de análise de risco por vez. A tela da ClearSale não liga com a Konduto ligada, e a da Konduto não liga com a ClearSale ligada. Para trocar de serviço, desligue o atual e grave, depois ligue o novo.
Quais pedidos passam pela análise
Só pedidos no cartão de crédito, e só nestes gateways:
- Sempre — Braavo Pay v2, Cielo, Getnet, Getnet v2, Rede e Rede v2.
- Quando você liga a opção de análise de risco na tela do gateway — Stone e PagSeguro v4 ("Usar a análise de risco da loja") e Mercado Pago ("Usar a análise de risco externa").
O pedido entra na fila no momento da compra, e só se a ClearSale ou a Konduto já estiverem ligadas. Pedidos feitos antes de ligar o serviço não são enviados sozinhos, mas você pode agendá-los um a um (veja "A listagem de Análise de Risco", abaixo). O pagamento pelo Apple Pay, na Rede, não passa pela análise.
Configurar a ClearSale ou a Konduto
O botão Ajustes abre a Visão geral, com um selo de estado para cada serviço (Ativa, Ativa em testes, Sem credencial, Desligada ou Não configurada) e o botão Configurar, que abre a tela dele. As telas de ajuste abrem só para administradores de Acesso total.
Na tela da ClearSale, preencha o Login, a Senha e o App fornecidos pela ClearSale e ligue Usar a ClearSale na análise de risco. O App identifica a loja no reconhecimento do aparelho do cliente, feito no checkout. Ao gravar com a ClearSale ligada, a loja confere o login e a senha na hora e mostra o resultado: se a ClearSale não encontrar o login, a análise é desligada, e a tela pede para conferir a credencial.
Na tela da Konduto, preencha a Chave pública e a Chave privada da conta e ligue Usar a Konduto na análise de risco. A chave pública vai no script da Konduto, nas páginas da loja; a privada fica guardada no servidor.
Atenção: copie a URL de notificação da tela e cadastre no painel da Konduto ou informe à ClearSale. É por esse endereço que o serviço avisa o resultado da análise. Sem ele, o pedido é analisado, mas o pagamento fica parado, esperando a captura ou o cancelamento no pedido.
A ClearSale tem também a seção Ambiente de testes, com login, senha e App próprios, que aparecem quando você liga o interruptor ao lado do título dela. Em testes, o resultado da análise não captura nem cancela nenhum pagamento, então use o ambiente só para validar a integração.
O que acontece com o resultado
- Pedido aprovado — o pagamento é capturado no gateway.
- Pedido em revisão (a análise manual do serviço) — o pagamento continua só autorizado, esperando a decisão final.
- Pedido reprovado — o pagamento é cancelado no gateway.
No PagSeguro v4 com a Konduto, o resultado não chega ao gateway: a captura e o cancelamento são feitos no pedido.
A listagem de Análise de Risco
Cada linha é um pedido na fila, com a data da última atualização, se já foi enviado, as tentativas, o serviço que fez a análise, o código e o status do pedido e o cliente. Clicando no nome do cliente, você tem:
- Visualizar — a resposta completa que o serviço devolveu. É onde você entende por que um pedido foi recusado.
- Ver pedido — abre o pedido.
- Reagendar — devolve o pedido para a fila, para uma nova análise na próxima rodada. Também aparece em Visualizar e nas ações em lote dos selecionados.
- Apagar — remove o registro da fila.
No topo, o botão Fila > Agendar abre o formulário Agendamento, para colocar na fila um pedido que não entrou sozinho: você escolhe o Serviço, informa o Código do Pedido e clica em Agendar. O Enviar > Todos processa a fila na hora, sem esperar a rodada automática, e o Exportar gera a planilha dos registros. Para achar um pedido, use Filtrar por... com Serviço, Pedido, Enviado, Tentativas, Data Início e Data Fim.
A fila envia só pedidos com o status Aguardando Pagto ou Em Análise. Um pedido que já foi aprovado ou cancelado por outro caminho não volta para a análise, mesmo reagendado. Para entrar na análise, o pedido precisa também da transmissão do pagamento com a resposta do gateway (veja o artigo sobre a tela de Transmissões); sem ela, a fila o deixa pendente para a próxima rodada.