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://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 |