addToFraudList
Pour rechercher dans la page utiliser Ctrl+F sur votre clavier
Cette opération permet d’ajouter un numéro de carte, de token ou de transaction (via le couple transactionIid/transactionDate ou transactionReference) à différents types de liste fraude.
interfaceVersion recommandée : FR_WS_2.55
Urls des environnements
-
- PROD
-
https://sherlocks-office-server.secure.lcl.fr/rs-services/v2/fraud/addToFraudList
- méthode
- POST
-
- TEST
-
https://office-server-sherlocks.test.sips-services.com/rs-services/v2/fraud/addToFraudList
- méthode
- POST
-
- PROD
-
https://sherlocks-office-server.secure.lcl.fr/services/v2/fraud?wsdl
- méthode
- POST
-
- TEST
-
https://office-server-sherlocks.test.sips-services.com/services/v2/fraud?wsdl
- méthode
- POST
Requête
Obligatoire
-
fraudListElementValue
- présence
- Obligatoire
- Interface version
- 2.15
En fonction du fraudListElementType, ce champ désigne la liste fraude utilisée.Ci-après deux exemples de cas d’usage. fraudListElementType = PAN :fraudListElementValue contient une liste de numéros de carte. fraudListElementType = TRANSACTION_ID : fraudListElementValue contient une liste de couple transactionId - transactionDate sous la forme transactionId”@”transactionDate (exemple : 123987@20180919).
-
fraudListLevel
- présence
- Obligatoire
- Interface version
- 2.15
Niveau / Couleur de la liste de fraude à alimenter.
Liste des valeurs
Black
- Liste noire
Grey
- Liste grise
White
- Liste blanche
-
fraudListType
- présence
- Obligatoire
- Interface version
- 2.15
Code réponse de la fraude.
Liste des valeurs
BicList
- Liste de Bic
CardBinList
- Liste de Bin de carte
CardList
- Liste de carte
CustomerNameList
- Liste de nom d’acheteur
EmailList
- Liste d’email
IbanList
- Liste d’IBAN
IdList
- Liste d’ID
IpList
- Liste d’adresse IP
MandateList
- Liste de mandats
PhoneNumberList
- Liste de numéro de telephone
PostalCodeList
- Liste de code postal
-
interfaceVersion
- présence
- Obligatoire
- Interface version
- 2.15
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
FR_WS_2.
- interface Sherlock’s Office (SOAP) interface pour les fonctions de fraude.
-
keyVersion
- présence
- Obligatoire
- Interface version
- 2.15
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.15
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.15
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).
Conditionnel
-
fraudListElementType
- présence
- Conditionnel
- Interface version
- 2.15
Mode d’alimentation de la liste de type carte.
Liste des valeurs
PAN
- Alimentation de la liste de carte en Fraude avec le PAN
TOKEN
- Alimentation de la liste de carte en Fraude avec le Token
TRANSACTION_ID
- Alimentation de la liste de carte en Fraude avec l’identifiant de la transaction (transactionId, transactionDate)
TRANSACTION_REF
- Alimentation de la liste de carte en Fraude avec la référence de la transaction (transactionReference)
Optionnel
-
fraudListReasonCode
- présence
- Optionnel
- Interface version
- 2.15
Raison pour laquelle l’élément est ajouté dans la liste de la fraude.
Liste des valeurs
b2bCustomer
- Acheteur B2B
bin_rangeTrusted
- Série de carte de confiance
cardForbidden
- Carte interdite
cardHolderReject
- Rejet du porteur de carte
cardLost
- Carte perdue
cardStolen
- Carte volée
cardUnknown
- Carte inconnue
customerTrusted
- Acheteur de confiance
debitNotPossible
- Débit impossible
duplicatePaymentAttempt
- Tentative de paiement en double
emailTrusted
- Email de confiance
emailUnknown
- Email inconnu
externallyBlackListed
- Présent dans liste noire externe
fraudSuspicion
- Suspicion de fraude
fromMdiFiles
- Issu de fichiers Mdi
generalSuspicion
- Générale suspicion
ibanTrusted
- IBAN de confiance
ipTrusted
- Adresse IP de confiance
ipUnknown
- Adresse IP inconnue
mandateTrusted
- Mandat de confiance
nameTrusted
- Nom de confiance
negativeExperience
- Expérience négative
notSpecified
- Non spécifié
panTrusted
- PAN de confiance
phoneTrusted
- Téléphone de confiance
phoneUnknown
- Téléphone inconnu
positiveExperience
- Expérience positive
specialAction
- action spéciale
travelCards
- Cartes de voyage
unpaid
- Impayé
vip
- VIP
zipUnknown
- Zip inconnu
-
intermediateServiceProviderId
- présence
- Optionnel
- Interface version
- 2.15
Identifiant du service utilisé par le commerçant pour les échanges de flux avec la plateforme Sherlock’s.
-
sealAlgorithm
- présence
- Optionnel
- Interface version
- 2.15
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
Exemple de requête
Réponse
Obligatoire
-
seal
- présence
- Obligatoire
- Interface version
- 2.15
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
-
errorFieldName
- présence
- Optionnel
- Interface version
- 2.15
Nom du champ en erreur dans la requête. Présent lorsque responseCode = 12 ou 30.
-
fraudResponseCode
- présence
- Optionnel
- Interface version
- 2.15
Code réponse du serveur Sherlock’s pour l’alimentation de la liste de fraude.
Exemple de réponse
Changelog
Interface version | Donnée | Présence | Conteneur |
---|---|---|---|
2.15 |
fraudListReasonCode
|
Requête | |
2.15 |
intermediateServiceProviderId
|
Requête | |
2.15 |
sealAlgorithm
|
Requête | |
2.15 |
fraudListElementValue
|
Requête | |
2.15 |
fraudListLevel
|
Requête | |
2.15 |
fraudListType
|
Requête | |
2.15 |
interfaceVersion
|
Requête | |
2.15 |
keyVersion
|
Requête | |
2.15 |
merchantId
|
Requête | |
2.15 |
seal
|
Requête/Réponse | |
2.15 |
fraudListElementType
|
Requête | |
2.15 |
errorFieldName
|
Réponse | |
2.15 |
fraudResponseCode
|
Réponse |