getFraudData
Pour rechercher dans la page utiliser Ctrl+F sur votre clavier
Cette opéraiton permet de récupérer des informations relatives au contrôle anti-fraude d’une transaction créée préalablement à l’aide de “Sherlock’s et stockée dans la base de données Sherlock’s.”
interfaceVersion recommandée : DR_WS_2.55
Urls des environnements
-
- PROD
-
https://sherlocks-office-server.secure.lcl.fr/rs-services/v2/diagnostic/getFraudData
- méthode
- POST
-
- TEST
-
https://office-server-sherlocks.test.sips-services.com/rs-services/v2/diagnostic/getFraudData
- méthode
- POST
-
- PROD
-
https://sherlocks-office-server.secure.lcl.fr/services/v2/diagnostic?wsdl
- méthode
- POST
-
- TEST
-
https://office-server-sherlocks.test.sips-services.com/services/v2/diagnostic?wsdl
- méthode
- POST
Requête
Obligatoire
-
interfaceVersion
- présence
- Obligatoire
- Interface version
- 2.13
Version de l’interface utilisée. Elle est composée d’un préfixe qui varie selon la fonction utilisée et d’un numéro de version (ex : IR_WS_2.47).
Veuillez-vous référer à la page de la fonction pour connaître la valeur à utiliser. Utilisez le dernier numéro d’interfaceVersion.
Liste des valeurs
DR_WS_2.
- interface Sherlock’s Office (SOAP/JSON) pour les fonctions de diagnostique.
-
keyVersion
- présence
- Obligatoire
- Interface version
- 2.13
Version de la clé secrète du commerçant utilisée pour calculer l’empreinte du message (clé stockée par le commerçant pour vérifier l’empreinte des notifications automatiques et manuelles).
-
merchantId
- présence
- Obligatoire
- Interface version
- 2.13
Identifiant de la boutique, sa valeur est fournie par Sherlock’s au commerçant lors de l’inscription de sa boutique.
-
seal
- présence
- Obligatoire
- Interface version
- 2.13
Sceau du message utilisé pour assurer l’intégrité de la requête et l’authentification de l’émetteur/destinataire du message (partage de la clé secrète).
Optionnel
-
intermediateServiceProviderId
- présence
- Optionnel
- Interface version
- 2.13
Identifiant du service utilisé par le commerçant pour les échanges de flux avec la plateforme Sherlock’s.
-
s10TransactionReference
- présence
- Optionnel
- Interface version
- 2.13
Contient les informations sur l’identification de la transaction, compatible avec Sherlock’s 1.0.Contient le s10TransactionId / s10TransactionIdDate qui assure l’unicité de la transaction 1.0.
Contient
-
s10TransactionId
- présence
- Optionnel
- Interface version
- 2.13
Le commerçant a le choix d’identifier ses transactions par un transactionId ou par un transactionReference (mode par défaut). s10TransactionId est un identifiant alternatif de la transaction compatible avec Sherlock’s 1.0. Il identifie une transaction de manière unique sur une journée. Le couple s10TransactionId/s10TransactionIdDate assure l’unicité de la transaction.
-
s10TransactionIdDate
- présence
- Optionnel
- Interface version
- 2.13
Date de la transaction (exprimée dans le time zone du serveur Sherlock’s).Le couple s10TransactionId/s10TransactionIdDate assure l’unicité de la transaction 1.0.L’utilisation de ce couple en lieu et place de la donnée transactionReference dépend de la configuration du commerçant.
-
sealAlgorithm
- présence
- Optionnel
- Interface version
- 2.13
Algorithme de cryptage utilisé pour le calcul du sceau.
Liste des valeurs
HMAC-SHA-256
- L’algorithme de cryptage utilisé est HMAC-SHA-256
HMAC-SHA-512
- L’algorithme de cryptage utilisé est HMAC-SHA-512
SHA-256
- L’algorithme de cryptage utilisé est SHA-256
-
transactionReference
- présence
- Optionnel
- Interface version
- 2.13
Le commerçant a le choix d’identifier ses transactions par un transactionReference (mode par défaut) ou par un transactionId. transactionReference identifie de manière unique une transaction tout au long de la vie de la boutique.
Exemple de requête
Réponse
Obligatoire
-
seal
- présence
- Obligatoire
- Interface version
- 2.13
Sceau du message utilisé pour assurer l’intégrité de la requête et l’authentification de l’émetteur/destinataire du message (partage de la clé secrète).
Optionnel
-
complementaryCode
- présence
- Optionnel
- Interface version
- 2.13
Ce champ n’est renseigné que si vous avez adhéré à l’un des contrôles complémentaires de Sherlock’s e-payment solution. Code réponse complémentaire du serveur Sherlock’s renvoyé dans la réponse.
Liste des valeurs
00
- Tous les contrôles auxquels vous avez adhérés se sont effectués avec succès Règle Fraude : Tous
02
- La carte utilisée a dépassé l’en-cours autorisé Règle Fraude : Encours carte
03
- La carte utilisée appartient à la « liste grise » du commerçant Règle Fraude : Liste grise de numéros de carte
04
- Valeur obsolète. Le code postal appartient à une plage définie dans la « liste grise » du commerçant Règle Fraude : Liste grise de codes postaux
05
- Valeur obsolète. Le BIN de la carte utilisée appartient à une plage non référencée dans la table des BIN de la plate-forme Sherlock’s Règle Fraude : Pays de la carte / Carte commerciale (et pays de la carte)
06
- Le code pays associé au numéro de carte n’appartient pas à la liste des pays autorisés par le commerçant Règle Fraude : Pays de la carte
07
- Carte virtuelle (e-Carte) détectée Règle Fraude : Carte virtuelle
08
- Le BIN de la carte utilisée appartient à une plage définie dans la « liste grise » du commerçant Règle Fraude : Liste grise de plages de BIN
09
- Valeur obsolète. Pays IP inconnu Règle Fraude : Pays de l’adresse IP
10
- Pays IP interdit Règle Fraude : Pays de l’adresse IP
11
- Carte présente en liste d’opposition Règle Fraude : Carte en opposition
12
- Combinaison pays de la carte / pays de l’adresse IP interdite Règle Fraude : Pays de la carte et de l’adresse IP
13
- Valeur obsolète. Pays IP ou carte inconnu. Le code pays n’est pas déterminable à partir du numéro de carte Règle Fraude : Combinaison pays de la carte et pays de l’adresse IP
14
- Carte à autorisation systématique Règle Fraude : Carte à autorisation systématique
15
- Valeur obsolète. BIN inconnu (sur le contrôle de carte à autorisation systématique) Règle Fraude : Carte à autorisation systématique
16
- En-cours d’adresses IP dépassé Règle Fraude : Encours par adresses IP
17
- Blocage relatif au statut de l’authentification 3-D Secure Règle Fraude : Authentification 3-D Secure
18
- Le numéro de carte correspond à un numéro de carte commerciale Règle Fraude : Carte commerciale
19
- Le numéro de carte n’appartient pas au réseau CB Règle Fraude : Carte Réseau CB
20
- En-cours client dépassé Règle Fraude : Encours par identifiant client
21
- En-cours client par carte dépassé Règle Fraude : Nombre de clients par carte
22
- En-cours de carte par client dépassé Règle Fraude : Nombre de cartes par client
23
- La date de fin de validité de la carte est proche Règle Fraude : Date d’expiration de la carte
24
- Pour usage futur
25
- Le montant est en dehors de l’intervalle défini Règle Fraude : Plage de montants
26
- Les adresses de facturation et de livraison sont différentes Règle Fraude : Codes postaux de livraison et de facturation
27
- Au moins l’une des adresses e-mail fournies appartient à un service de courrier électronique gratuit Règle Fraude : Adresse e-mail gratuite
28
- L’identifiant du client appartient à la « liste noire » du commerçant Règle Fraude : Liste noire d’identifiants client
29
- L’identifiant du client appartient à la « liste grise » du commerçant Règle Fraude : Liste grise d’identifiants client
30
- Les pays de facturation et de livraison sont différents Règle Fraude : Pays de livraison et de facturation
31
- Au moins l’une des adresses e-mail fournies appartient à la « liste noire » du commerçant Règle Fraude : Liste noire d’adresses e-mail
32
- Au moins l’une des adresses e-mail fournies appartient à la « liste grise » du commerçant Règle Fraude : Liste grise d’adresses e-mail
33
- Au moins l’un des numéros de téléphone fournis appartient à la « liste noire » du commerçant Règle Fraude : Liste noire de numéros de téléphone
34
- Au moins l’un des numéros de téléphone fournis appartient à la « liste grise » du commerçant Règle Fraude : Liste grise de numéros de téléphone
35
- Au moins l’un des noms de contact fournis appartient à la « liste noire » du commerçant Règle Fraude : Liste noire de noms de client
36
- Au moins l’un des noms de contact fournis appartient à la « liste grise » du commerçant Règle Fraude : Liste grise de noms de client
37
- L’adresse IP de l’acheteur appartient à la « liste noire » du commerçant Règle Fraude : Liste noire d’adresses IP
38
- L’adresse IP de l’acheteur appartient à la « liste grise » du commerçant Règle Fraude : Liste grise d’adresses IP
39
- La combinaison pays / code postal appartient à la « liste noire » du commerçant Règle Fraude : Liste noire de codes postaux
3L
- Refus de la transaction en raison de non garantie de la transaction par une entité (l’acquéreur, le fournisseur de portefeuille, etc) Règle Fraude : Garantie d’authentification
40
- La combinaison pays / code postal appartient à la « liste grise » du commerçant Règle Fraude : Liste grise de codes postaux
41
- Le BIN de la carte utilisée appartient à une plage définie dans la « liste noire » du commerçant Règle Fraude : Liste noire de plages de BIN
42
- Combinaison pays de la carte / pays de livraison interdite Règle Fraude : Pays de livraison et de la carte
43
- Le numéro de carte correspond à un numéro de carte commerciale et le pays d’émission de la carte ne correspond pas à un pays accepté par le commerçant Règle Fraude : Carte commerciale (et pays de la carte)
44
- L’adresse IP de l’acheteur est interdite Règle Fraude : Réputations d’adresse IP
45
- Le seuil du nombre de cartes différentes pour une même adresse IP est dépassé. Règle Fraude : Nombre de cartes par adresse IP
46
- Le format de l’adresse e-mail fournie n’est pas correct Règle Fraude : Syntaxe d’adresse e-mail
47
- Combinaison pays de la carte / pays de facturation interdite Règle Fraude : Pays de facturation et de la carte
50
- La carte utilisée appartient à la « liste noire » du commerçant Règle Fraude : Liste noire de numéros de carte
51
- Au moins un produit du panier appartient à une liste de produits à risque Règle fraude : Liste de produits risqués
52
- Au moins un produit du panier appartenant à une liste de produits à risque a une quantité supérieure au seuil paramétré dans la règle et/ou la quantité totale des produits appartenant à une liste de produits à risque est supérieure au seuil paramétré dans la règle Règle fraude : Quanttié de produits à risque
53
- Le plus grand ratio entre le montant total pour au moins un produit appartenant à une liste de produits à risque et le montant total du panier est supérieur au seuil paramétré dans la règle et/ou le ratio entre le montant total de tous les produits appartenant à une liste de produits à risque et le montant total du panier est supérieur au seuil paramétré dans la règle Règle fraude : Ratio de produits à risque
54
- Au moins un produit du panier a une quantité supérieure au seuil paramétré dans la règle Règle fraude : Quantité de produits
55
- Le pays de l’IBAN est dans la liste des pays interdits ou n’est pas dans la liste des pays autorisés ou est différent de votre pays Règle fraude : Pays de l’IBAN
56
- La combinaison du pays de livraison et du pays de l’IBAN est interdite Règle fraude : Pays de livraison et de l’IBAN
57
- La combinaison du pays du numéro de téléphone portable du client et du pays de l’IBAN est interdite Règle fraude : Pays du numéro de téléphone et de l’IBAN
58
- La combinaison du pays de l’adresse IP et du pays de l’IBAN est interdite Règle fraude : Pays de l’adresse IP et de l’IBAN
59
- Le nombre d’IBAN différents provenant de la même adresse IP sur la période dépasse la limite acceptée Règle fraude : Nombre d’IBAN par adresse IP
60
- Le nombre d’adresses IP différentes avec le même IBAN sur la période dépasse la limite acceptée Règle fraude : Nombre d’adresses IP par IBAN
61
- Le nombre de clients différents utilisant le même IBAN sur la période dépasse la limite acceptée Règle fraude : Nombre de clients par IBAN
62
- Le nombre d’IBAN différents utilisés par le même client sur la période dépasse la limite acceptée Règle fraude : Nombre d’IBAN par client
63
- Le nombre de mandats différents provenant de la même adresse IP sur la période dépasse la limite acceptée Règle fraude : Nombre de mandats par adresse IP
64
- Le nombre des transactions effectuées et/ou la somme des montants cumulés avec ce mandat sur la période dépasse(nt) la/les limite(s) acceptée(s) Règle fraude : Encours par mandat
65
- Le nombre des transactions effectuées et/ou la somme des montants cumulés avec cet IBAN sur la période dépasse(nt) la/les limite(s) acceptée(s) Règle fraude : Encours par IBAN
66
- Le BIC fait partie de la liste Règle fraude : Liste noire de BIC
67
- Le BIC fait partie de la liste Règle fraude : Liste grise de BIC
68
- L’IBAN fait partie de la liste Règle fraude : Liste noire d’IBAN
69
- L’IBAN fait partie de la liste Règle fraude : Liste grise d’IBAN
70
- Le RUM du mandat fait partie de la liste Règle fraude : Liste noire de mandats
71
- Le RUM du mandat fait partie de la liste Règle fraude : Liste grise de mandats
72
- Carte prépayée détectée Règle fraude : Carte prépayée
73
- Pays d’émission invalide. Règle fraude : Pays de l’émission de la carte
74
- Combinaison du pays de facturation et du pays d’émission de la carte. Règle fraude : Pays de l’émission de la carte et de facturation
75
- Combinaison du pays de livraison et du pays d’émission de la carte. Règle fraude : Pays de l’émission de la carte et de livraison
76
- Combinaison du pays de l’adresse et pays d’émission de la carte. Règle fraude : Pays de l’émission de la carte et de l’adresse IP
77
- Carte commerciale avec un pays d’émission invalide. Règle fraude : Carte commerciale (et pays d’émission de la carte)
99
- le serveur Sherlock’s a un rencontré un problème lors du traitement d’un des contrôles locaux complémentaires Règle Fraude : Tous
AA
- Le numéro de carte appartient à la « liste blanche » du commerçant Règle Fraude : Liste blanche de numéros de carte
AB
- L’identifiant du client appartient à la « liste blanche » du commerçant Règle Fraude : Liste blanche d’identifiants client
AC
- Au moins l’une des adresses e-mail fournies appartient à la « liste blanche » du commerçant Règle Fraude : Liste blanche d’adresses e-mail
AD
- Au moins l’un des numéros de téléphone fournis appartient à la « liste blanche » du commerçant Règle Fraude : Liste blanche de numéros de téléphone
AE
- L’adresse IP de l’acheteur appartient à la « liste blanche » du commerçant Règle Fraude : Liste blanche d’adresses IP
AF
- Au moins l’un des noms de contact fournis appartient à la « liste blanche » du commerçant Règle Fraude : Liste blanche de noms de client
AG
- La combinaison pays / code postal appartient à la « liste blanche » du commerçant Règle Fraude : Liste blanche de codes postaux
AH
- Le BIN de la carte utilisée appartient à une plage définie dans la « liste blanche » du commerçant Règle Fraude : Liste blanche de plages de BIN
AI
- Le BIC de l’acheteur appartient à la « liste blanche » du commerçant Règle Fraude : Liste blanche de BIC
AJ
- L’IBAN de l’acheteur appartient à la « liste blanche » du commerçant Règle Fraude : Liste blanche d’IBAN
AK
- Le mandat SDD de l’acheteur appartient à la « liste blanche » du commerçant Règle Fraude : Liste blanche de mandats
Empty
- Pas de contrôle effectué. Règle Fraude : Aucune
-
errorFieldName
- présence
- Optionnel
- Interface version
- 2.21
Nom du champ en erreur dans la requête. Présent lorsque responseCode = 12 ou 30.
-
fraudResponseCode
- présence
- Optionnel
- Interface version
- 2.13
Code réponse du serveur Sherlock’s pour l’alimentation de la liste de fraude.
-
preAuthenticationColor
- présence
- Optionnel
- Interface version
- 2.13
Couleur associée au résultat des règles antifraudes de pré-authentification. Utilisé pour déclencher le niveau d’authentification adéquat pour la transaction.
Liste des valeurs
BLACK
- Couleur du score Noire
Empty
- Aucun contrôle
GREEN
- Couleur du score Verte
ORANGE
- Couleur du score Orange
RED
- Couleur du score Rouge
WHITE
- Couleur du score Blanche
-
preAuthenticationProfile
- présence
- Optionnel
- Interface version
- 2.13
Nom du profil pré-authentification utilisé.
-
preAuthenticationProfileValue
- présence
- Optionnel
- Interface version
- 2.13
Identifiant du profil du contrôle antifraude utilisé lors de la pré-authentification. Contrairement au nom du profil, l’identifiant unique prend en compte la surcharge dynamique et le contournement des règles antifraudes. Cet identifiant permet de retrouver toutes les règles antifraudes appliquées sur une transaction à des fins de justification en cas de litige.
-
preAuthenticationRuleResultList
- présence
- Optionnel
- Interface version
- 2.13
Liste contenant le résultat d’exécution de chaque règle antifraude, lors de la pré-authentification.
Contient
-
ruleResult
- présence
- Optionnel
- Interface version
- 2.13
Résultat détaillé de la règle antifraude.
Contient
-
ruleCode
- présence
- Optionnel
- Interface version
- 2.13
Identifiant de règle antifraude.
-
ruleDetailedInfo
- présence
- Optionnel
- Interface version
- 2.13
Informations détaillées retournées par une règle antifraude. Par exemple, pour une règle sur le pays d’une carte, le pays de la carte est retourné.
-
ruleResultIndicator
- présence
- Optionnel
- Interface version
- 2.13
Indicateur d’éxecution de la règle antifraude.
-
ruleSetting
- présence
- Optionnel
- Interface version
- 2.13
Mode de mise en place des paramètres de la règle antifraude.
-
ruleType
- présence
- Optionnel
- Interface version
- 2.13
Type de règle antifraude.
-
ruleWeight
- présence
- Optionnel
- Interface version
- 2.13
Pondération de la règle antifraude.
-
preAuthenticationThreshold
- présence
- Optionnel
- Interface version
- 2.13
Seuil pour déterminer le niveau de risque d’une transaction en étape pré-authentification.
-
preAuthenticationValue
- présence
- Optionnel
- Interface version
- 2.13
Résultat antifraude du contrôle d’authentification.
-
preAuthorisationProfile
- présence
- Optionnel
- Interface version
- 2.13
Nom du profil pré-autorisation utilisé.
-
preAuthorisationProfileValue
- présence
- Optionnel
- Interface version
- 2.13
Identifiant unique du profil du contrôle antifraude appliqué lors de la pré-autorisation. Contrairement au nom du profil, l’identifiant unique prend en compte la surcharge dynamique et le contournement des règles antifraudes. Cet identifiant permet de retrouver toutes les règles antifraudes appliquées sur une transaction à des fins de justification en cas de litige.
-
preAuthorisationRuleResultList
- présence
- Optionnel
- Interface version
- 2.13
Liste contenant le résultat de chacune des règles antifraudes exécutées au cours de la phase de pré-autorisation.
Contient
-
ruleResult
- présence
- Optionnel
- Interface version
- 2.13
Résultat détaillé de la règle antifraude.
Contient
-
ruleCode
- présence
- Optionnel
- Interface version
- 2.13
Identifiant de règle antifraude.
-
ruleDetailedInfo
- présence
- Optionnel
- Interface version
- 2.13
Informations détaillées retournées par une règle antifraude. Par exemple, pour une règle sur le pays d’une carte, le pays de la carte est retourné.
-
ruleResultIndicator
- présence
- Optionnel
- Interface version
- 2.13
Indicateur d’éxecution de la règle antifraude.
-
ruleSetting
- présence
- Optionnel
- Interface version
- 2.13
Mode de mise en place des paramètres de la règle antifraude.
-
ruleType
- présence
- Optionnel
- Interface version
- 2.13
Type de règle antifraude.
-
ruleWeight
- présence
- Optionnel
- Interface version
- 2.13
Pondération de la règle antifraude.
-
scoreColor
- présence
- Optionnel
- Interface version
- 2.13
Couleur associée au score. Utilisé pour donner un rapport sur les règles antifraudes appliquées lors d’une requête de paiement. Le module Business Score attribue à chaque transaction une note (score) qui indique le degré de risque que vous prenez si vous acceptez la transaction. Une couleur est également associée à ce score au travers du champ scoreColor.
Liste des valeurs
BLACK
- Couleur du score Noire
Empty
- Aucun contrôle
GREEN
- Couleur du score Verte
ORANGE
- Couleur du score Orange
RED
- Couleur du score Rouge
WHITE
- Couleur du score Blanche
-
scoreProfile
- présence
- Optionnel
- Interface version
- 2.13
Nom associé au profil utilisé pour calculer le score de la transaction. Le module Business Score attribue à chaque transaction une note (score) qui indique le degré de risque que vous prenez si vous acceptez la transaction. Une couleur est également associée à ce scre au travers du champ scoreColor.
-
scoreThreshold
- présence
- Optionnel
- Interface version
- 2.13
Seuil pour déterminer le niveau de risque d’une transaction en étape pré-autorisation.Le module Business Score attribue à chaque transaction une note (score) qui indique le degré de risque que vous prenez si vous acceptez la transaction. Une couleur est également associée à ce scre au travers du champ scoreColor.
-
scoreValue
- présence
- Optionnel
- Interface version
- 2.13
Nombre relatif représentant le score de la transaction. Valeur du score Pré-Autorisation calculé par le moteur de Fraude en mode Business Score.
Exemple de réponse
Changelog