Release 24.5

aller directement au contenu

Rechercher par mots clés

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

  • 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

Obligatoire

Optionnel

Exemple de requête

            {
  "interfaceVersion": "DR_WS_2.13",
  "keyVersion": "1",
  "merchantId": "029107704346091",
  "sealAlgorithm": "SHA-256",
  "transactionReference": "12345678945613",
  "seal": "1b30f5b8bfb1739adf716e5c86c67e5034c91c29cd2651a5e0b8d6e5e12a6be5"
}

        
                  <urn:getFraudData>
         <urn:input>
            <urn:merchantId>201999999999005</urn:merchantId>
            <urn:interfaceVersion>DR_WS_2.13</urn:interfaceVersion>
            <urn:transactionReference>SIM20160425155355</urn:transactionReference>
         </urn:input>
      </urn:getFraudData>

        

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
  • 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
  • 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

            {
  "fraudResponseCode": "00",
  "preAuthorisationProfile": "MP0050",
  "preAuthorisationRuleResultList": [
    {
      "ruleCode": "CA",
      "ruleType": "N",
      "ruleWeight": "4",
      "ruleSetting": "S",
      "ruleResultIndicator": "-4",
      "ruleDetailedInfo": "MIN\u003d1000:2000;MAX\u003d1000:100000"
    },
    {
      "ruleCode": "PE",
      "ruleType": "N",
      "ruleWeight": "4",
      "ruleSetting": "S",
      "ruleResultIndicator": "0",
      "ruleDetailedInfo": "EXPIRY\u003d1216:0616"
    },
    {
      "ruleCode": "EC",
      "ruleType": "N",
      "ruleWeight": "2",
      "ruleSetting": "N",
      "ruleResultIndicator": "U"
    }
  ],
  "scoreColor": "BLACK",
  "scoreProfile": "MP0050",
  "scoreThreshold": "-17;-8",
  "scoreValue": "-4.0",
  "seal": "0c67850db20d23c8efd5f186c8f03104b697f1b4f49ef18af18cddf74b01bcbb"
}

        
                  <getFraudDataResponse xmlns="urn:sips:cn:contract:office:diagnostic:v2">
         <output>
            <fraudResponseCode>00</fraudResponseCode>
            <preAuthorisationProfile>MP0050</preAuthorisationProfile>
            <ruleResultList>
               <preAuthorisationRuleResult>
                  <ruleCode>CA</ruleCode>
                  <ruleType>N</ruleType>
                  <ruleWeight>4</ruleWeight>
                  <ruleSetting>S</ruleSetting>
                  <ruleResultIndicator>-4</ruleResultIndicator>
                  <ruleDetailedInfo>MIN=1000:2000;MAX=1000:100000</ruleDetailedInfo>
               </preAuthorisationRuleResult>
               <preAuthorisationRuleResult>
                  <ruleCode>VI</ruleCode>
                  <ruleType>N</ruleType>
                  <ruleWeight>4</ruleWeight>
                  <ruleSetting>S</ruleSetting>
                  <ruleResultIndicator>0</ruleResultIndicator>
                  <ruleDetailedInfo>TRANS=1:2;CUMUL=1000:100000</ruleDetailedInfo>
               </preAuthorisationRuleResult>
            </ruleResultList>
            <scoreColor>BLACK</scoreColor>
            <scoreProfile>MP0050</scoreProfile>
            <scoreThreshold>-17;-8</scoreThreshold>
            <scoreValue>-4.0</scoreValue>
         </output>
      </getFraudDataResponse>

        

Changelog


Interface version Donnée Présence Conteneur
2.13 interfaceVersion Requête
2.13 keyVersion Requête
2.13 merchantId Requête
2.13 seal Requête/Réponse
2.13 intermediateServiceProviderId Requête
2.13 s10TransactionReference Requête
2.13 s10TransactionId Conteneur
  • s10TransactionReference
  • 2.13 s10TransactionIdDate Conteneur
  • s10TransactionReference
  • 2.13 sealAlgorithm Requête
    2.13 transactionReference Requête
    2.13 complementaryCode Réponse
    2.21 errorFieldName Réponse
    2.13 fraudResponseCode Réponse
    2.13 preAuthenticationColor Réponse
    2.13 preAuthenticationProfile Réponse
    2.13 preAuthenticationProfileValue Réponse
    2.13 preAuthenticationRuleResultList Réponse
    2.13 ruleResult Conteneur
  • preAuthenticationRuleResultList
  • preAuthorisationRuleResultList
  • 2.13 ruleCode Conteneur
  • ruleResult
  • 2.13 ruleDetailedInfo Conteneur
  • ruleResult
  • 2.13 ruleResultIndicator Conteneur
  • ruleResult
  • 2.13 ruleSetting Conteneur
  • ruleResult
  • 2.13 ruleType Conteneur
  • ruleResult
  • 2.13 ruleWeight Conteneur
  • ruleResult
  • 2.13 preAuthenticationThreshold Réponse
    2.13 preAuthenticationValue Réponse
    2.13 preAuthorisationProfile Réponse
    2.13 preAuthorisationProfileValue Réponse
    2.13 preAuthorisationRuleResultList Réponse
    2.13 scoreColor Réponse
    2.13 scoreProfile Réponse
    2.13 scoreThreshold Réponse
    2.13 scoreValue Réponse
    Retourner en haut de page Besoin d'aide ?

    Besoin d'aide ?

    Fermer

    Ce site utilise des traceurs pour améliorer votre expérience de navigation, effectuer des analyses et des recherches sur votre utilisation du site web de documentation Sherlock's.
    En fermant ce bandeau vous refusez notre utilisation des traceurs sur votre appareil.

    Paramètres