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.
Commentaire: titre

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.

diagramDisplayName

Diagramme draw.io
contentId1129578826zoom1pageId1121355152
diagramName
Diagramme Paiement 3DS Direct
V2
lbox
width
1
1254
contentVer
links
11
undefined
revision
zoom
11
1
baseUrlhttps://payline.atlassian.net/wikidiagramName
tbstyleundefined
diagramDisplayNameDiagramme Paiement 3DS Direct V2
lbox
width
true
1254
contentVer
links
16
undefined
height
tbstyle
482
undefined
revision
height
16

Les étapes : 422

  1. Le consommateur valide son panier afin que le marchand prépare la page web ou seront renseignés les données de paiement, en appelant le service Payline « doWebPayment». Un message « VEReq » (Verification enrollment request) permettant l’accès au Directory Serveur  vérifiera l’inscription de la carte dans l’annuaire contenant les cartes déclarées « enrôlées » 3-D Secure et et les URL des ACS correspondants. La réponse « VERes » (Verification enrollment response) contenant le résultat de l’authentification sera retourné au Merchand Plug-in (MPI) pour gérer le dialogue avec le Directory et l’ACS en vue de permettre à l’acheteur de s’authentifier.
  2. La demande « PAReq » (Payer authentification request) permet l’accès à l’ACS de la banque du porteur et déclenchera la phase d’authentification.
  3. La réponse « PARes »(Payer authentification response), contenant le résultat de l’authentification du porteur de la carte sera transmis au commerçant qui déclenchera une demande d’autorisation et de validation de paiement en appelant le service doAuthorizationRequest qui interrogera la banque acquéreur.
  4. En fonction de la réponse de la banque (doAuthorizationResponse), le paiement sera enregistré ou non et la réponse sera transmise à l’acheteur.
  5. et renseigne ses données de paiement afin que Payline vérifie l'enrollement sur la demande du merchand avec le service verifyEnrollment ;
  6. Le marchand redirige le consommateur sur la page d'authentification de la banque ; 
  7. Le marchand peut alors réaliser une demande de paiement avec les informations d'authentification avec le service doAuthorisation ; 
  8. 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 
VerifyEnrollmentRequestResponse

Vous devez d'abord demander la vérification de l'enrollement de la carte bancaire à Payline avec le service verifyEnrollement.

Exemple de configuration :

verifyEnrollment
verifyEnrollmentRequestverifyEnrollmentResponse
ElémentsValeursElémentsValeurs
version18
18selectedContractList
version18
card.number497010XXXXXX1646result.code03000
card.expirationDate1222result.shortMessageACCEPTED
card.cvx123result.longMessageTransaction accepted
VADCB*
payment.amount10000termurlName*
1000
TermUrl
payment.action101termurlValue*NULL
payment.mode
ActionUrl
CPTmdFieldName*MD
CPT
payment.
contratNumber
contractNumber
actionMethod
VAD3DS
VADCB
mdFieldValue*
buyer.customerid
2KJw5rL1N7pZRsfS8Xiw
pareqFieldName
orderRef
123456order.ref PHP123456returnURLhttps://demo.payline.com/~kitphp/examples/demos/web.php?e=getWebPaymentDetailscancelURL
PHP1544091439pareqFieldName*PaReq


pareqFieldValue*eJxVkW9vgjAQxr+K8QPQ8k/AnE10bJlZ1MXpsr0yTbkMohQsMMVPvxZxbq96v+fa691zsEkVYvyGolHIYIFVxb9wkCWT..


actionMethodPOST


ActionUrlhttps://
demo.payline
~kitphp/examples/demos/web.php?e=getWebPaymentDetails

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

mdpayacs/pareq


token4970zSIkspmH5670

* Attention les

** Attention ces

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

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

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
paremètre
paramètre
pareqFieldValuevaleur du paramètre pareqFieldName
termUrlNamenom du
paremètre
paramètre
termUrlValuevaleur du paramètre termUrlName
midFieldNamenom du
paremètre
paramè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

informations MD et pares en retour de l'authentification 3DS pour

réaliser

les transmettre dans la demande de paiement à Payline :

Exemple de configuration :

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
getTransactionDetail Demande de paiement 3DS 
getTransactionDetails 

Vous devez récupérer toutes les informations en appelant le service getTransactionDetails : 

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