Aller au contenu principal
Sur cette page

Le mode Ombre permet aux commerçants d'évaluer en parallèle un ou plusieurs fournisseurs antifraude sans interrompre le flux de transaction.

Ceci est particulièrement utile pour comparer les performances de détection de fraude ou pour étalonner les modèles à l'aide de données en temps réel, sans impact sur les approbations en direct ou l'expérience client.

Comment ça marche ?#

Lorsque le mode Ombre est activé, DEUNA traite chaque transaction à travers votre principal fournisseur de services antifraude et le fournisseur d'ombre.

Le fournisseur d'ombre fonctionne en parallèle et reçoit les mêmes données de transaction que le fournisseur principal. Toutefois, son évaluation sans effet la décision d'achat ou le flux de paiement — il est exécuté uniquement à des fins de comparaison et de surveillance.

Une fois la transaction terminée, DEUNA inclut le résultat de l'évaluation du fournisseur d'ombre dans la réponse de l'API. Le résultat est retourné dans le fraud_shadowmode Objet, qui reflète la structure de la principale réaction de fraude.

Vous pouvez accéder au mode ombre de la manière suivante :

  • GET /order — la réponse du fournisseur d'ombres est incluse dans la fraud_shadowmode field.
  • Réponse API d'achat — contient également les mêmes fraud_shadowmode object.

Cela vous permet de comparer en toute sécurité les résultats des deux fournisseurs, de déceler les écarts dans l'évaluation des risques et de prendre des décisions fondées sur les données avant de changer de fournisseur ou de mettre à jour votre stratégie de fraude.

Configuration#

Pour activer le mode Ombre, vous devez définir un fournisseur d'ombre dans votre configuration de stratégie de fraude. Le fournisseur fictif reçoit la même demande de transaction que la principale, mais son évaluation fonctionne silencieusement et ne bloque jamais ou n'approuve jamais un paiement.

Si votre fournisseur sélectionné a besoin d'un empreinte digitale de l'appareil, DEUNA réutilise automatiquement la valeur d'empreintes digitales envoyée dans l'appel API principal. Seulement une empreinte digitale est supporté par transaction, et la même valeur est partagée entre les fournisseurs principaux et les fournisseurs fictifs.

Cela garantit l'uniformité des données dans les évaluations, évitant ainsi les erreurs de notation dues à des empreintes digitales différentes.

1. Activer le mode Ombre

La première étape pour configurer le mode Ombre dans vos stratégies de paiement est de l'activer au niveau marchand.

  1. Allez à la section Commerce du portail de l'administrateur DEUNA.
  2. Ouvrez l'onglet Paramètres de paiement.
  3. Dans la section Paramètres de fraude, activez le basculement :

Activer le fournisseur antifraude en mode ombre Le mode Ombre permet une évaluation synchrone de la fraude sans empêcher le traitement de la transaction par le processeur de paiement.

Une fois ce réglage activé, le mode Ombre peut être configuré dans vos stratégies de paiement.

2. Configurer le mode Ombre

Configurer le mode Ombre pour une stratégie de paiement en sélectionnant un ou plusieurs fournisseurs antifraude pour exécuter en mode Ombre.

Exemple interactifUtilise des données fictives et n’effectue aucune requête API.
Production
Paiements

Stratégies de paiement

Configurez le traitement par défaut et les règles de chaque flux de paiement.

Acme LATAM · Production

Traitement par défaut

Configurez le traitement par défaut et les règles de chaque flux de paiement.

RègleRoutageStatutAction
Traitement par défautAdyen → WorldpayActive

Règles spécifiques

Configurez le traitement par défaut et les règles de chaque flux de paiement.

1 règle fictiveProcesseurs de paiement
PrioritéRègleConditionsRoutageStatut
1Commandes de valeur élevéeMontant supérieur à 100 USDAdyen → WorldpayActive
  1. Allez à la section Stratégies de paiement.
  2. Créer une nouvelle stratégie ou modifier une stratégie existante.
  3. Naviguez dans la section Paramètres de fraude.
  4. Trouvez la zone Mode Ombre et choisissez les fournisseurs que vous souhaitez tester.

Vous pouvez affecter différents fournisseurs pour :

  • Débit de préautorisation
  • Flux après autorisation

Plusieurs fournisseurs peuvent être configurés par flux.

3. Résultats en mode Ombre

Une fois le mode Ombre actif et une transaction traitée, vous pouvez afficher les résultats dans les détails de la commande ou dans la réponse de l'API.

3.1 Résultat de la commande:

  1. Naviguez sur la page Détails de la commande.
  2. Faites défiler vers la section Sécurité.
  3. Une sous-section appelée -Offrant antifraude (mode Shadow) - apparaîtra.
  4. Pour chaque fournisseur d'ombre, vous verrez :
    • Nom du fournisseur
    • Score de risque
    • Niveau de risque (p. ex. faible, moyen, élevé)
    • Réponse du processeur et tous les détails pertinents


Les résultats du mode ombre peuvent également être examinés à partir de la Visibilité des transactions section dans la page Détails de la commande.

Vous pourrez inspecter la demande et la réponse envoyées au fournisseur d'ombres, vous permettant de la comparer avec le comportement principal du fournisseur.

3.2 Affichage des résultats du mode Ombre dans la réponse de l'API

La réponse comprend fraud_shadowmode objet où vous pouvez trouver la liste des fournisseurs antifraude configurés et les résultats de chacun

JSON
"fraud_shadowmode": [
  {
    "analysis": {
      "details": "approved",
      "fraud_decision": "low_risk",
      "processor": "RISKIFIED",
      "processor_response": "approved",
      "risk_level": "low",
      "score": "0",
      "status": "automatic_decision",
      "type": ""
    },
    "status": "accepted"
  }
]

Cet objet a les paramètres suivants :

ChampTapezDescriptif
fraud_shadowmodearrayListe des évaluations antifraude réalisées en mode ombre.
analysisobjectAnalyse antifraude détaillée renvoyée par le processeur.
analysis.processorstringFournisseur de lutte contre la fraude qui a exécuté l'analyse.
analysis.fraud_decisionstringDécision de fraude rendue par le transformateur.
analysis.risk_levelstringNiveau de risque attribué à la transaction.
analysis.detailsstringDétails de décision lisibles par l'homme.
analysis.processor_responsestringRéponse brute retournée par le fournisseur de services antifraude.
analysis.scorenumberLa cote de risque attribuée à la transaction. Il revient 0 quand il n'est pas récupéré par le fournisseur antifraude. Certains antifraudes, comme Riskified, ne reviennent pas à marquer dans leur réponse.
analysis.statusstringType d'exécution de la décision.
analysis.typestringZone réservée pour les types de classification ou de règles futurs.
statusstringRésultat de l'opération suggéré sur la base d'une analyse antifraude.
Comportement de l'état
analysis.fraud_decisionanalysis.risk_levelstatus
low_risklowaccepted
high_riskhighrejected
medium_riskmediummanual_review

Notes/Limitations#

  • Un fournisseur ne peut pas être configuré comme les deux principal et ombre prestataire de services dans le cadre de la même stratégie de fraude.
  • Le mode Ombre fonctionne en parallèle et n'affecte pas les décisions de paiement ou de latence transactionnelle dans des conditions normales.
  • Si le fournisseur d'ombres ne répond pas, il n'interrompra pas l'évaluation du fournisseur principal.

En outre, les transactions traitées en mode Ombre sont entièrement visibles dans le Visibilité des transactions section du tableau de bord. Vous pouvez inspecter les deux demande et Réponse envoyé au fournisseur d'ombres pour comprendre comment son évaluation diffère de votre fournisseur principal.