Mode ombre
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_shadowmodefield. - Réponse API d'achat — contient également les mêmes
fraud_shadowmodeobject.
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.
- Allez à la section Commerce du portail de l'administrateur DEUNA.
- Ouvrez l'onglet Paramètres de paiement.
- 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.
Stratégies de paiement
Configurez le traitement par défaut et les règles de chaque flux de paiement.
Traitement par défaut
Configurez le traitement par défaut et les règles de chaque flux de paiement.
| Règle | Routage | Statut | Action |
|---|---|---|---|
| Traitement par défaut | Adyen → Worldpay | Active |
Règles spécifiques
Configurez le traitement par défaut et les règles de chaque flux de paiement.
| Priorité | Règle | Conditions | Routage | Statut |
|---|---|---|---|---|
| 1 | Commandes de valeur élevée | Montant supérieur à 100 USD | Adyen → Worldpay | Active |
- Allez à la section Stratégies de paiement.
- Créer une nouvelle stratégie ou modifier une stratégie existante.
- Naviguez dans la section Paramètres de fraude.
- 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:
- Naviguez sur la page Détails de la commande.
- Faites défiler vers la section Sécurité.
- Une sous-section appelée -Offrant antifraude (mode Shadow) - apparaîtra.
- 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
"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 :
| Champ | Tapez | Descriptif |
|---|---|---|
fraud_shadowmode | array | Liste des évaluations antifraude réalisées en mode ombre. |
analysis | object | Analyse antifraude détaillée renvoyée par le processeur. |
analysis.processor | string | Fournisseur de lutte contre la fraude qui a exécuté l'analyse. |
analysis.fraud_decision | string | Décision de fraude rendue par le transformateur. |
analysis.risk_level | string | Niveau de risque attribué à la transaction. |
analysis.details | string | Détails de décision lisibles par l'homme. |
analysis.processor_response | string | Réponse brute retournée par le fournisseur de services antifraude. |
analysis.score | number | La 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.status | string | Type d'exécution de la décision. |
analysis.type | string | Zone réservée pour les types de classification ou de règles futurs. |
status | string | Résultat de l'opération suggéré sur la base d'une analyse antifraude. |
Comportement de l'état
analysis.fraud_decision | analysis.risk_level | status |
|---|---|---|
low_risk | low | accepted |
high_risk | high | rejected |
medium_risk | medium | manual_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.