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.58
Urls des environnements
-
- PROD
-
https://office-server.mercanet.com/rs-services/v2/fraud/addToFraudList - méthode
- POST
-
- TEST
-
https://office-server-mercanet.test.sips-services.com/rs-services/v2/fraud/addToFraudList - méthode
- POST
-
- PROD
-
https://office-server.mercanet.com/services/v2/fraud?wsdl - méthode
- POST
-
- TEST
-
https://office-server-mercanet.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 Office (M2M) (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 Mercanet 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
B2B_CUSTOMER- Acheteur B2B
BIN_RANGE_TRUSTED- Série de carte de confiance
CARD_FORBIDDEN- Carte interdite
CARD_HOLDER_REJECT- Rejet du porteur de carte
CARD_LOST- Carte perdue
CARD_STOLEN- Carte volée
CARD_UNKNOWN- Carte inconnue
CUSTOMER_TRUSTED- Acheteur de confiance
DEBIT_NOT_POSSIBLE- Débit impossible
DUPLICATE_PAYMENT_ATTEMPT- Tentative de paiement en double
EMAIL_TRUSTED- Email de confiance
EMAIL_UNKNOWN- Email inconnu
EXTERNALLY_BLACK_LISTED- Présent dans liste noire externe
FRAUD_SUSPICION- Suspicion de fraude
FROM_MDI_FILES- Issu de fichiers Mdi
GENERAL_SUSPICION- Générale suspicion
IBAN_TRUSTED- IBAN de confiance
IP_TRUSTED- Adresse IP de confiance
IP_UNKNOWN- Adresse IP inconnue
MANDATE_TRUSTED- Mandat de confiance
NAME_TRUSTED- Nom de confiance
NEGATIVE_EXPERIENCE- Expérience négative
NOT_SPECIFIED- Non spécifié
PAN_TRUSTED- PAN de confiance
PHONE_TRUSTED- Téléphone de confiance
PHONE_UNKNOWN- Téléphone inconnu
POSITIVE_EXPERIENCE- Expérience positive
SPECIAL_ACTION- action spéciale
TRAVEL_CARDS- Cartes de voyage
UNPAID- Impayé
VIP- VIP
ZIP_UNKNOWN- 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 Mercanet.
-
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 Mercanet 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 |