Documentation Monext Online

Arborescence des pages

Comparaison des versions

Ancienne version 22

changes.mady.by.user Guillaume VENTRE

Sauvegardée le

comparé à

Nouvelle version 23

changes.mady.by.user Rodolphe GARIN

Sauvegardée le

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.

Contenu

Sommaire
maxLevel2
stylenone

CU10 - Paiement 3DS en direct

Le

principe 

Le paiement 3D Secure se réalise en deux étapes : 

  • Vérification de l'enrôlement de la carte au système 3D Secure et authentification du porteur.
  • Demande de paiement.

Pour plus d'information concernant le traitement 3D Secure, veuillez cliquer ici.


Intégration

Vous devez utiliser les web services  verifyEnrollment et doAuthorization de l'API Payline.


Diagramme draw.io
contentId1129578826
zoom1
pageId1121355152
diagramDisplayNameDiagramme Paiement 3DS Direct V2
lbox1
contentVer13
revision13
baseUrlhttps://payline.atlassian.net/wiki
diagramNameDiagramme Paiement 3DS Direct
width1254
linksundefined
tbstyleundefined
height501


  1. Le consommateur valide son panier et renseigne ses données de paiement afin que Payline vérifie l'enrollement sur la demande du merchand avec le service verifyEnrollment ;
  2. Le marchand redirige le consommateur sur la page d'authentification de la banque ; 
  3. Le marchand peut alors réaliser une demande de paiement avec les informations d'authentification avec le service doAuthorisation ; 
  4. Le marchand doit récupérer les informations de la transaction avec le service getTransactionDetails.


Les services de l'API


Volet


Développer
title1. Demande de vérification de l'enrollement de la carte avec le service VerifyEnrollment 


VerifyEnrollment
RequestResponse
version18version18
card.number497010XXXXXX1646result
Informations sur le résultat de la vérification d'enrollement :
00000 : Transaction approved
01xxx : Transaction refused
021xx : Internal Error
.code03000
card.expirationDate1222
termurlFieldNameContient  le nom du champ  "TermUrl" à Poster.
result.shortMessageACCEPTED
card.cvx123
result.longMessageTransaction accepted
payment.amount10000termurlFieldName
termurlFieldValue
**
Contient  la valeur du champ  "TermUrl".
TermUrl
payment.action101termurlFieldValue**NULL
payment.
amount
mode
10000
CPTmdFieldName
Contient  le nom du champ  "MD field".
**MD
payment.contractNumberVAD3DS
orderRefREF00021
mdFieldValue**
Contient  la valeur du champ  "MD field" à Poster.walletIdL’identifiant du portefeuille de l’acheteur. La balise version doit être remplie avec la valeur égale ou supérieure à 10.ActionUrl**URL de l’ACS.walletCardIndL’index de la carte de l’acheteur enregistré dans le portefeuille. La balise version doit être remplie avec la valeur égale ou supérieure à 10.actionMethodMéthode d’envoi .Retourne une valeur POST ou GET. Post par défaut.generateVirtualCvxDemande de génération d’un CVV virtuel.
Vérifier si votre abonnement permet cette fonctionnalité (Tokenization).pareqFieldNameNom du champ “Pareq à Poster.merchantNameNom affiché sur la page d'authentification de l'ACSpareqFieldValue**
2KJw5rL1N7pZRsfS8Xiw
orderRefPHP1544091439pareqFieldNamePaReq


pareqFieldValue**eJxVkW9vgjAQxr+K8QPQ8k/AnE10bJlZ1MXpsr0yTbkMohQsMMVPvxZxbq96v+fa691zsEkVYvyGolHIYIFVxb9wkCWT..


actionMethodPOST


ActionUrlhttps://3ds-acs.test.modirum.com/mdpayacs/pareq


token4970zSIkspmH5670
Contient la Valeur du champ PaReq.

* nom de l'alias donné au contrat VAD du moyen de paiement

** Attention

ces

les valeurs sont générés de manière dynamique et se renouvelleront pour chaque message.




Volet


Développer
title2. Redirection du consommateur pour l'authentification

Une fois le verifyEnrollment réalisé, vous devez réaliser la demande d'authentification 3DS du consommateur.

Pour cela, vous devez rediriger le consommateur sur l'URL ActionUrl avec les paramètres que vous trouvez dans la réponse du service verifyEnrollement.

Vérifier la méthode utilisée POST ou GET de actionMethod. 

  • en POST vous poster un formulaire  les noms et les valeurs des champs ;
  • en GET vous pourrez transmettre les noms et les valeurs en paramètres de l'URL.


(avertissement)  Les paramètres sont indiqués par les champs et les valeurs dynamiquement : à chaque appel, ils peuvent être modifiés. 

pareqFieldNamenom du paremètre
pareqFieldValuevaleur du paramètre pareqFieldName
termUrlNamenom du paremètre
termUrlValuevaleur du paramètre termUrlName
midFieldNamenom du paremètre
midFieldNamevaleur du paramètre midFieldName






Volet


Développer
title3. La demande de paiement avec le service
doAuthorisation 
doAuthorization 

Vous devez récupérer les informlations MD en retour de l'authentification 3DS pour réaliser la demande de paiement :

doAuthorisation
doAuthorization
RequestResponse
version
result.code00000
payment.amount
result.shortmessageACCPTED
payment.action101result.longmessageTransaction approved
token1gZKPUeSufwDtQkVo3071534757637648redirectURLhttps://homologation-webpayment.payline.com/webpayment/step1.do?reqCode=prepareStep1&token=1gZKPUeSufwDtQkVo3071534757637648* nom de l'alias donné au contrat VAD du moyen de paiement
payment.modeCPTtransaction.id28340115745009
payment.contractNumberVAD3DStransaction.date07/04/2018 11:27:45
card.number4970100012345670authorization.numberACCOR0
card.expirationDate1222authorization.date07/04/2018 11:27:45
card.cvx123card.number497010XXXXXX5670
order.refPHP1544091439card.typeCB
buyer.customerIdID12654895card.expirationDate1222
3DSecure.md2KJw5rL1N7pZRsfS8Xiwcard.token4970zSIkspmH5670

3DSecure.pares

eJxVkW9vgjAQxr+K8QPQ8k/AnE10bJlZ1MXpsr0yTbkMohQsMMVPvxZxbq96v+fa691zsEkVYvyGolHIYIFVxb9wkCWT..contractNumberVAD3DS





Volet


Développer
title4. Récupération du détail de la transaction avec le service getTransactionDetails 

4. Récupération du détail de la transaction avec le

service getTransactionDetail Demande de paiement 3DS 

service 

getTransactionDetails

RequestResponse
transactionId28340115745009
getTransactionDetail 
result.code00000
orderRefPHP1544091439result.shortmessageACCPTED
version18result.longmessageTransaction approved
token1gZKPUeSufwDtQkVo3071534757637648redirectURLhttps://homologation-webpayment.payline.com/webpayment/step1.do?reqCode=prepareStep1&token=1gZKPUeSufwDtQkVo3071534757637648


transaction.....


payment.....


authorization....


order.....


buyer.....




Exemple du centre administration

Image Removed


Exemple de l'écran du détail de la transaction

Image Added