getVelocityData
Pour rechercher dans la page utiliser Ctrl+F sur votre clavier
Cette opération permet de contrôler l’activité d’un champ de données spécifique au cours d’une période déterminée.
interfaceVersion recommandée : FR_WS_2.55
Urls des environnements
-
- PROD
-
https://office-server.mercanet.com/rs-services/v2/fraud/getVelocityData
- méthode
- POST
-
- TEST
-
https://office-server-mercanet.test.sips-services.com/rs-services/v2/fraud/getVelocityData
- 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
-
interfaceVersion
- présence
- Obligatoire
- Interface version
- 2.0
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.0
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.0
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.0
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).
-
velocityElementType
- présence
- Obligatoire
- Interface version
- 2.0
Type de contrôle de vélocité. (exemple: contrôle d’en cours carte, customerId, IP ..).
Liste des valeurs
IP
- IP de l’Internaute
card
- Carte du porteur
customerId
- Identifiant du client
-
velocityElementValue
- présence
- Obligatoire
- Interface version
- 2.0
Valeur de l’élément de contrôle de vélocité.(exemple: adresse IP pour contrôle vélocité IP). Valeur correspondant à l’élément sur lequel le commerçant souhaite effectuer un contrôle de vélocité.
Optionnel
-
intermediateServiceProviderId
- présence
- Optionnel
- Interface version
- 2.12
Identifiant du service utilisé par le commerçant pour les échanges de flux avec la plateforme Mercanet.
-
sealAlgorithm
- présence
- Optionnel
- Interface version
- 2.12
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
-
velocityPeriod
- présence
- Optionnel
- Interface version
- 2.0
Période sur laquelle la vélocité est demandée.(exemple: contrôle en-cours sur une période de 2 jours)
Exemple de requête
Réponse
Obligatoire
-
seal
- présence
- Obligatoire
- Interface version
- 2.0
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
-
currencyCode
- présence
- Optionnel
- Interface version
- 2.0
Code de la devise de la transaction. Ce code est compatible ISO 4217.
Liste des valeurs
032
- Peso argentin
036
- Dollar australien
048
- Dinar de Bahreïn
116
- Riel cambodgien
124
- Dollar canadien
144
- Roupie sri lankaise
156
- Yuan Renminbi
191
- Kuna croate
203
- Couronne tchèque
208
- Couronne danoise
344
- Dollar de Hong Kong
348
- Forint hongrois
352
- Couronne islandaise
356
- Roupie indienne
376
- Nouveau Shekel israélien
392
- Yen japonais
410
- Won coréen
414
- Dinar koweïtien
458
- Ringgit malaisien
480
- Roupie de Maurice
484
- Peso mexicain
524
- Roupie népalaise
554
- Dollar néo-zélandais
578
- Couronne norvégienne
634
- Rial qatari
643
- Rouble russe
682
- Riyal saoudien
702
- Dollar de Singapour
710
- Rand sud-africain
752
- Couronne suédoise
756
- Franc suisse
764
- Baht thaïlandais
784
- Dirham des Émirats arabes unis
788
- Dinar tunisien
826
- Livre Sterling
840
- Dollar américain
901
- Dollar de Taiwan
941
- Dinar serbe
946
- Leu roumain
949
- Nouvelle livre turque
952
- Franc CFA
953
- Franc Pacifique
975
- Lev bulgare
978
- Euro
980
- Hryvnia ukrainien
985
- Zloty polonaise
986
- Real brésilien
-
errorFieldName
- présence
- Optionnel
- Interface version
- 2.21
Nom du champ en erreur dans la requête. Présent lorsque responseCode = 12 ou 30.
-
responseCode
- présence
- Optionnel
- Interface version
- 2.0
Code réponse du serveur Mercanet.
Liste des valeurs
00
- Opération acceptée
03
- Contrat commerçant invalide
99
- Problème temporaire du serveur de paiement.
-
velocityNbTransaction
- présence
- Optionnel
- Interface version
- 2.0
Nombre de transactions effectuées sur la période.
-
velocityProfileDateTime
- présence
- Optionnel
- Interface version
- 2.0
Date de dernière modification du profil actif pour les encours.
-
velocityProfileMaxNbTrans
- présence
- Optionnel
- Interface version
- 2.0
Nombre de transactions maximum autorisé pour la règle de vélocité du type demandé.(exemple: Alerte si plus de 3 transactions)
-
velocityProfileMaxTotalAmount
- présence
- Optionnel
- Interface version
- 2.0
Montant maximum cumulé autorisé pour la règle de vélocité du type demandé.(exemple: Alerte si montant cumulé des transaction dépasse 500,00 euros)
-
velocityProfileMaxTransAmount
- présence
- Optionnel
- Interface version
- 2.0
Montant maximum autorisé de la transaction pour la règle de vélocité du type demandé.(exemple: Alerte si montant transaction supérieur à 200 euros)
-
velocityProfileName
- présence
- Optionnel
- Interface version
- 2.0
Période exprimée en nombre de jours pour laquelle le commerçant souhaite les informations de vélocité.
-
velocityProfilePeriod
- présence
- Optionnel
- Interface version
- 2.0
Période exprimée en nombre de jours sur laquelle est appliquée la règle de vélocité.(exemple: contrôle en-cours sur une période de 2 jours)
-
velocityTotalAmount
- présence
- Optionnel
- Interface version
- 2.0
Montant cumulé des transactions effectuées sur la période sur la règle de vélocité (ex. montant cumulé de 400 euros effectués sur la période)
Exemple de réponse
Changelog
Interface version | Donnée | Présence | Conteneur |
---|---|---|---|
2.12 |
intermediateServiceProviderId
|
Requête | |
2.12 |
sealAlgorithm
|
Requête | |
2.0 |
velocityPeriod
|
Requête | |
2.0 |
interfaceVersion
|
Requête | |
2.0 |
keyVersion
|
Requête | |
2.0 |
merchantId
|
Requête | |
2.0 |
seal
|
Requête/Réponse | |
2.0 |
velocityElementType
|
Requête | |
2.0 |
velocityElementValue
|
Requête | |
2.0 |
currencyCode
|
Réponse | |
2.21 |
errorFieldName
|
Réponse | |
2.0 |
responseCode
|
Réponse | |
2.0 |
velocityNbTransaction
|
Réponse | |
2.0 |
velocityProfileDateTime
|
Réponse | |
2.0 |
velocityProfileMaxNbTrans
|
Réponse | |
2.0 |
velocityProfileMaxTotalAmount
|
Réponse | |
2.0 |
velocityProfileMaxTransAmount
|
Réponse | |
2.0 |
velocityProfileName
|
Réponse | |
2.0 |
velocityProfilePeriod
|
Réponse | |
2.0 |
velocityTotalAmount
|
Réponse |