MaxMind minFraud Factors : le prix des raisons

Vous ouvrez la file d’examen du matin et comparez deux commandes. Le score de chacune est proche de 1, bien dans la plage d’acceptation. Elles sont arrivées dans la file parce qu’une règle d’échantillonnage les a sélectionnées. Les informations sur les clients semblent ordinaires et les montants des paiements sont proches. Les scores ne permettent pas de les départager utilement : au premier examen, les deux décisions semblent presque identiques. Puis vous regardez les motifs associés à chaque résultat. Les deux commandes ont obtenu un score similaire, mais à partir de combinaisons de signaux différentes. Quand les chiffres sont presque identiques, que révèlent les éléments qui les sous-tendent ?

Ce que renvoie Factors

Factors renvoie tout ce que contient Insights, ainsi que les raisons associées au score. Chaque raison est identifiée par un code. MaxMind fournit une phrase explicative et un multiplicateur compris entre 0,01 et 100. Les multiplicateurs supérieurs à 1 font monter le score, ceux qui sont inférieurs à 1 le font baisser.

Score coûte 0,005 $ par requête. Insights coûte 0,015 $. Factors coûte 0,020 $, soit quatre fois le prix de Score.

Les raisons ont remplacé les anciens sous-scores. MaxMind les a abandonnés en octobre 2024 et a annoncé leur suppression pour mars 2025 dans ses notes de version.

Au même moment, le même score

Lors d’un test le 5 octobre 2026, une commande a été soumise à Score, Insights et Factors au cours de trois séries. L’ordre des appels a changé à chaque série, et les neuf appels ont renvoyé 0,93. Factors a renvoyé les mêmes raisons à chaque fois.

Lors d’appels espacés de quelques minutes, les scores obtenus auparavant étaient différents. L’historique du réseau avait évolué entre les appels. Dans notre test, les trois services interrogés au même moment ont renvoyé le même score : avec Factors, le prix plus élevé donne aussi accès aux raisons.

Quand les raisons justifient leur prix

La commande provenant d’une adresse IP de cloud à Francfort a obtenu un score de 3,08 avec Factors. Selon le seuil d’acceptation de 5,00 ou moins donné en exemple par MaxMind, ce score se situe dans la zone d’acceptation. Factors a indiqué ANONYMOUS_IP ×12,5. La commande facturée à New York a obtenu 0,16 et affichait ISSUER_ID_NUMBER_COUNTRY_MISMATCH ×4, alors qu’aucune information de carte n’avait été envoyée.

Graphiques des facteurs : les raisons font monter ou baisser les scores. 42,64 pour New York–Prague et 0,8 pour Prague, où les informations concordent
Les raisons qui ont fait monter ou baisser deux scores réels (dossier de démonstration)

Sur le graphique, la commande pour Prague, où les informations concordent, et celle expédiée à l’étranger ont la même raison liée à une nouvelle adresse e-mail. Pour la commande destinée à Prague, trois raisons à la baisse accompagnent un score final de 0,80. L’examinateur voit ce qui a fait baisser le score, comme ce qui l’a fait monter.

Decisimo decision engine

Intégrez ces contrôles à un flux de décision

Créez des règles de crédit, de fraude ou de recouvrement, puis appliquez-les aux décisions réelles.

Les codes renvoyés lors de nos appels

Voici les codes renvoyés lors de nos appels, avec les explications de MaxMind :

CodeRaison
ANONYMOUS_IPL’adresse IP anonyme a fait monter le score de risque global
EMAIL_ACTIVITYL’activité de l’adresse e-mail sur le réseau minFraud a fait monter le score de risque global
EMAIL_DOMAINLe domaine de l’adresse e-mail a fait monter ou baisser le score de risque global
EMAIL_FIRST_SEENLe fait que l’adresse e-mail soit vue pour la première fois sur le réseau minFraud a fait monter le score de risque global
IP_ACTIVITYL’activité de l’adresse IP sur le réseau minFraud a fait monter le score de risque global
ISSUER_ID_NUMBER_COUNTRY_MISMATCHL’écart entre le pays de l’adresse IP, de facturation et d’expédition, et celui de l’IIN, a fait monter le score de risque global
ORG_DISTANCE_RISKLe risque associé au fournisseur d’accès à Internet, combiné à la distance entre l’adresse de facturation et la localisation de l’adresse IP, a fait baisser le score de risque global
SHIP_ACTIVITYL’activité de l’adresse d’expédition sur le réseau minFraud a fait monter ou baisser le score de risque global

L’effet d’un code peut varier d’une commande à l’autre. Dans certains appels, EMAIL_DOMAIN a fait monter le score pour une adresse e-mail temporaire et l’a fait baisser pour une adresse professionnelle. MaxMind indique que la liste des codes en vigueur peut être fournie sur demande. Une règle qui utilise ces codes doit donc prévoir le cas d’un code inconnu.

Flux de décision de lutte contre la fraude

  1. Effectuer vos propres vérifications avant l’appel à Factors.
  2. Afficher les raisons à côté du score pour l’examinateur.
  3. Utiliser directement un code comme condition d’une règle lorsqu’il motive la décision, comme ANONYMOUS_IP.
  4. Prévoir une branche pour tout code inconnu dans chaque règle qui utilise des codes.
  5. Interpréter le multiplicateur comme un poids appliqué au score, et non comme une probabilité à lui seul.
  6. Définir la réponse de vos règles en cas d’échec d’un appel. Les sources en échec renvoient des valeurs absentes avec un indicateur d’erreur. Une source n’est réessayée que si elle est marquée comme répétable.
  7. Transmettre les résultats des transactions via l’API Report Transactions de MaxMind.

Cas d’usage

Création de compte

Lors de la création d’un compte, une raison peut donner à l’examinateur des éléments de contexte lorsque le score seul ne montre pas ce qui l’a fait monter. MaxMind accepte la création de compte comme type d’événement.

Paiement et validation de commande

Au moment du paiement, un code comme ANONYMOUS_IP peut directement servir de critère dans une règle. Si la commande est envoyée en examen, l’examinateur peut aussi voir la raison à côté du score.

Crédit

Pour une demande de crédit, une raison peut éclairer l’examen du dossier. Si le processus prévoit une explication à l’intention du demandeur, celle-ci doit porter sur la décision prise. Une raison MaxMind décrit l’interprétation du score par le service.

Questions fréquentes

La liste des codes de raison est-elle fixe ?

MaxMind fournit la liste en vigueur uniquement sur demande. Toute règle qui utilise ces codes doit donc prévoir le cas d’un code qu’elle n’a encore jamais rencontré.

Peut-on montrer une raison au client ?

La raison explique ce qui, selon MaxMind, a fait monter ou baisser le score. Elle peut être présentée comme telle, en la distinguant de la décision prise et de l’explication qui l’accompagne.

Pourquoi une raison mentionne-t-elle une carte alors qu’aucune information n’a été envoyée ?

Lors de notre appel, la commande facturée à New York a renvoyé ISSUER_ID_NUMBER_COUNTRY_MISMATCH ×4, alors que la requête ne contenait aucune information de carte. La réponse n’explique pas pourquoi cette raison est apparue dans ce cas.

Que signifient les erreurs de l’API ?

Une erreur 429 indique que la requête a été limitée en débit et n’a pas été traitée. Une erreur 402 signifie que le compte n’a plus de crédit.

StatutCodeSignification
400JSON_INVALID, REQUEST_INVALIDLe corps de la requête n’est pas au format JSON ou ne contient aucune entrée valide
401AUTHORIZATION_INVALIDL’identifiant du compte ou la clé de licence est incorrect
402INSUFFICIENT_FUNDSLe compte n’a plus de crédit
403PERMISSION_REQUIREDLe compte n’est pas autorisé à utiliser ce service
429noneRequête limitée en débit, non traitée
500SERVER_ERRORErreur lors du traitement

Pour configurer la source de données, utilisez ensemble l’identifiant de compte MaxMind et la clé de licence comme un seul identifiant HTTP Basic. Enregistrez cet identifiant une seule fois, puis demandez à l’assistant de configurer la source de données à partir de la documentation des requêtes de MaxMind.

Decisimo decision engine

Intégrez ces contrôles à un flux de décision

Créez des règles de crédit, de fraude ou de recouvrement, puis appliquez-les aux décisions réelles.