MaxMind minFraud Factors: o custo dos motivos
Você abre a fila de análise da manhã e compara dois pedidos. Ambos tiveram pontuação próxima de 1, bem dentro do seu limite de aceitação, e chegaram à fila porque uma regra de amostragem os selecionou. Os dados dos clientes parecem comuns. Os valores das compras são parecidos. As pontuações não ajudam a diferenciá-los, então, na primeira análise, você fica com duas decisões quase iguais. Aí você consulta os motivos associados a cada resultado. Cada pedido chegou à pontuação por uma combinação diferente de sinais. Quando os números são quase iguais, o que as evidências por trás deles podem mostrar?
O que Factors retorna
Factors retorna tudo o que vem em Insights, além de motivos para a pontuação. Cada motivo traz um código. A MaxMind fornece uma frase explicativa e um multiplicador de 0,01 a 100. Multiplicadores acima de 1 aumentam a pontuação, e os abaixo de 1 a reduzem.
Score custa US$ 0,005 por consulta. Insights custa US$ 0,015. Factors custa US$ 0,020, quatro vezes o preço de Score.
Os motivos substituíram os subescores antigos. A MaxMind descontinuou esses subescores em outubro de 2024 e anunciou que os removeria em março de 2025 nas notas de release.
Chamadas no mesmo momento, mesma pontuação
Em um teste realizado em 5 de outubro de 2026, enviamos um pedido ao Score, ao Insights e ao Factors em três rodadas. A ordem das chamadas mudou a cada rodada, e as nove chamadas retornaram 0,93. Factors retornou os mesmos motivos todas as vezes.
Em chamadas anteriores, as pontuações foram diferentes quando havia alguns minutos entre elas. O histórico da rede mudou nesse intervalo. No nosso teste, as chamadas feitas no mesmo momento mostraram que o preço maior de Factors inclui os motivos junto com a mesma pontuação.
Quando os motivos justificam o preço
O pedido com IP de uma nuvem em Frankfurt teve pontuação de 3,08 no Factors. Considerando o limite de aceitação de 5,00 ou menos usado no exemplo da MaxMind, essa pontuação fica dentro do limite. Factors indicou ANONYMOUS_IP ×12,5. O pedido com endereço de cobrança em Nova York teve pontuação de 0,16 e veio com ISSUER_ID_NUMBER_COUNTRY_MISMATCH ×4, embora nenhum dado de cartão tenha sido enviado.
No gráfico, o pedido consistente de Praga e o pedido enviado para o exterior tinham o mesmo motivo relacionado a um e-mail novo. No pedido consistente de Praga, três motivos que reduziram a pontuação levaram ao resultado final de 0,80. Assim, quem analisa consegue ver tanto o que reduziu uma pontuação baixa quanto o que a aumentou.
Códigos retornados nas nossas chamadas
Estes são os códigos retornados nas nossas chamadas, com as descrições da MaxMind:
| Código | Motivo |
|---|---|
| ANONYMOUS_IP | O endereço IP anônimo aumentou a pontuação geral de risco |
| EMAIL_ACTIVITY | A atividade do endereço de e-mail na rede minFraud aumentou a pontuação geral de risco |
| EMAIL_DOMAIN | O domínio do e-mail aumentou ou reduziu a pontuação geral de risco |
| EMAIL_FIRST_SEEN | O fato de o endereço de e-mail aparecer pela primeira vez na rede minFraud aumentou a pontuação geral de risco |
| IP_ACTIVITY | A atividade do endereço IP na rede minFraud aumentou a pontuação geral de risco |
| ISSUER_ID_NUMBER_COUNTRY_MISMATCH | A divergência entre os países do IP, dos endereços de cobrança e de entrega e do IIN aumentou a pontuação geral de risco |
| ORG_DISTANCE_RISK | O risco do provedor de internet, combinado com a distância entre o endereço de cobrança e a localização do endereço IP, reduziu a pontuação geral de risco |
| SHIP_ACTIVITY | A atividade do endereço de entrega na rede minFraud aumentou ou reduziu a pontuação geral de risco |
O efeito de um código pode variar de um pedido para outro. Em algumas chamadas, EMAIL_DOMAIN aumentou a pontuação para um e-mail descartável e reduziu a pontuação para um endereço de e-mail comercial. A MaxMind informa que pode fornecer a lista atual de códigos mediante solicitação. Por isso, qualquer regra que use códigos precisa prever o que fazer quando recebe um código desconhecido.
Fluxo de decisão para fraude
- Faça suas próprias verificações antes de chamar Factors.
- Mostre os motivos ao lado da pontuação para quem analisa o caso.
- Use o próprio código como condição da regra quando ele determinar a decisão, como ANONYMOUS_IP.
- Inclua uma alternativa para códigos desconhecidos em toda regra que use códigos.
- Considere o multiplicador como um peso aplicado à pontuação, não como uma probabilidade isolada.
- Defina como suas regras respondem a uma chamada com falha. Fontes com falha retornam valores ausentes com um indicador de erro, e uma fonte só é chamada novamente se estiver marcada como repetível.
- Informe os resultados das transações pela API Report Transactions da MaxMind.
Onde usar
Criação de conta
Na criação de conta, o motivo pode dar contexto a quem analisa quando a pontuação, sozinha, não mostra o que a elevou. A MaxMind aceita a criação de conta como tipo de evento.
Checkout e pagamentos
No checkout, um código como ANONYMOUS_IP pode ser usado diretamente em uma regra. Se o pedido for encaminhado para análise, quem o avalia também poderá consultar o motivo ao lado da pontuação.
Crédito
Em uma solicitação de crédito, um motivo pode ajudar na análise. Se o processo exigir uma explicação para quem solicitou o crédito, baseie-a na sua decisão. O motivo da MaxMind descreve como o serviço chegou à pontuação.
Perguntas frequentes
A lista de códigos de motivo é fixa?
A MaxMind fornece a lista atual somente mediante solicitação. Por isso, uma regra que use códigos precisa prever o recebimento de um código que ainda não conhece.
Posso mostrar um motivo ao cliente?
O motivo explica o que, segundo a MaxMind, aumentou ou reduziu a pontuação do serviço. Você pode apresentá-lo dessa forma e deixar clara a diferença entre esse motivo, a sua decisão e qualquer explicação sobre ela.
Por que apareceu um motivo sobre cartão se não enviamos dados de cartão?
Na nossa chamada, o pedido com endereço de cobrança em Nova York retornou ISSUER_ID_NUMBER_COUNTRY_MISMATCH ×4, embora a solicitação não incluísse dados de cartão. A resposta não explica por que esse motivo apareceu nesse caso.
O que significam os erros da API?
O erro 429 indica que a chamada foi limitada por taxa e não foi processada. O erro 402 significa que a conta ficou sem crédito.
| Status | Código | Significado |
|---|---|---|
| 400 | JSON_INVALID, REQUEST_INVALID | O corpo não está em JSON ou não contém dados de entrada válidos |
| 401 | AUTHORIZATION_INVALID | O ID da conta ou a chave de licença está incorreto |
| 402 | INSUFFICIENT_FUNDS | A conta ficou sem crédito |
| 403 | PERMISSION_REQUIRED | A conta não tem permissão para usar este serviço |
| 429 | none | Chamada limitada por taxa, não processada |
| 500 | SERVER_ERROR | Erro durante o processamento |
Para configurar o acesso, use juntos o ID da conta MaxMind e a chave de licença como uma credencial HTTP Basic. Armazene a credencial uma única vez e peça ao assistente para configurar a fonte de dados com base na documentação de solicitações da MaxMind.
