Arborescence des pages

Comparaison des versions

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.

ContenuContent

Sommaire
maxLevel2
stylenone


CU10 - Paiement

3DS

en

Payment in direct mode

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.

payment is done in two steps:

  • Verification of the enrollment of the card to the 3D Secure system and authentication of the bearer.
  • Payment request. 


Integration

You must use the verifyEnrollment and doAuthorization web services of the Payline API

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
contentVer16
revision16
baseUrlhttps://payline.atlassian.net/wiki
diagramNameDiagramme Paiement 3DS Direct
width1254
linksundefined
tbstyleundefined
height482


Les étapes Steps :  

  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

  1. The consumer validates his basket and informs his payment data so that Payline verifies the enrollment on merchand request with the verifyEnrollment service;
  2. The merchant redirects the consumer to the bank's authentication page;
  3. The merchant can then make a payment request with the authentication information with the service doAuthorization;
  4. The merchant must retrieve transaction information with the getTransactionDetails service.


API services


Volet


Développer
title 1. Demande de vérification de l'enrollement de la carte avec le service VerifyEnrollment Verification Request for Card Enrollment with VerifyEnrollment Service
You must first request verification of the credit card registration with Payline with the verifyEnrollement service
Vous devez d'abord demander la vérification de l'enrollement de la carte bancaire à Payline avec le service verifyEnrollement
:
verifyEnrollment
RequestResponse
version18version18
card.number497010XXXXXX1646result.code03000
card.expirationDate1222result.shortMessageACCEPTED
card.cvx123result.longMessageTransaction accepted
payment.amount10000termurlName*TermUrl
payment.action101termurlValue*NULL
payment.modeCPTmdFieldName*MD
payment.contractNumberVAD3DSmdFieldValue*2KJw5rL1N7pZRsfS8Xiw
orderRefPHP1544091439pareqFieldName*PaReq


pareqFieldValue*eJxVkW9vgjAQxr+K8QPQ8k/AnE10bJlZ1MXpsr0yTbkMohQsMMVPvxZxbq96v+fa691zsEkVYvyGolHIYIFVxb9wkCWT..


actionMethodPOST


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


token4970zSIkspmH5670

* Attention les valeurs sont générés de manière dynamique et se renouvelleront pour chaque messagevalues ​​are generated dynamically and will be renewed for each request.




Volet


Développer
title2. Redirection du consommateur pour l'authentificationConsumer Redirection for Authentication

You must fulfill the consumer's 3DS authentication request.

To do it, you must redirect the consumer to ActionUrl  URL with the parameters that you find in verifyEnrollementResponse service.

Check the method used POST or GET of actionMethod.

  • in POST you post a method form with the names and values ​​of the fields: name and value, adding the termUrl on which the user will be redirected;
  • in GET you will be able to transmit the names and the values ​​in parameters of the URL.


(avertissement) The parameters are indicated by the fields and the values ​​dynamically: with each call, they can be modified.


pareqFieldName
parameter name
pareqFieldValue
parameter value pareqFieldName
termUrlNameparameter name
termUrlValueparameter value termUrlName
midFieldNameparameter name
midFieldNameparameter value midFieldName

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 verifyEnrollementResponse.

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

  • en POST vous poster un formulaire type 'form method' avec les noms et les valeurs des champs : name et value, en rajoutant le termUrl sur lequel l'utilisateur sera redirigé ;
  • 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 paramètre
pareqFieldValuevaleur du paramètre pareqFieldName
termUrlNamenom du paramètre
termUrlValuevaleur du paramètre termUrlName
midFieldNamenom du paramètre
midFieldNamevaleur du paramètre midFieldName





Volet


Développer
title3. La demande de paiement avec le service doAuthorization The payment request with the service doAuthorization

You must retrieve the MD information and pares back from the 3DS authentication to transmit them in the payment request to Vous devez récupérer les informations MD et pares en retour de l'authentification 3DS pour les transmettre dans la demande de paiement à Payline:

doAuthorization
RequestResponse
version
result.code00000
payment.amount
result.shortmessageACCPTED
payment.action101result.longmessageTransaction approved
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 Retrieving the details of the transaction with the service getTransactionDetails

You must retrieve all information by calling the getTransactionDetails service:Vous devez récupérer toutes les informations en appelant le service getTransactionDetails : 

getTransactionDetails

RequestResponse
transactionId28340115745009result.code00000
orderRefPHP1544091439result.shortmessageACCPTED
version18result.longmessageTransaction approved


transaction.....


payment.....


authorization....


order.....


buyer.....




Back Office example


Example of the transaction detail screen

Exemple du centre administration

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