Contenu
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.
- 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 ;
- Le marchand redirige le consommateur sur la page d'authentification de la banque ;
- Le marchand peut alors réaliser une demande de paiement avec les informations d'authentification avec le service doAuthorisation ;
- Le marchand doit récupérer les informations de la transaction avec le service getTransactionDetails.
1. Demande de vérification de l'enrollement de la carte avec le service VerifyEnrollment
VerifyEnrollment | |||
---|---|---|---|
Request | Response | ||
version | 18 | version | 18 |
card.number | 497010XXXXXX1646 | result | Informations sur le résultat de la vérification d'enrollement : 00000 : Transaction approved |
card.expirationDate | 1222 | ||
card.cvx | 123 | ||
payment.amount | 10000 | mdFieldName | Contient le nom du champ "MD field" |
payment.contractNumber | VAD3DS | ||
orderRef | REF00021 | mdFieldValue** | Contient la valeur du champ "MD field" à Poster |
ActionUrl** | URL de l’ACS | ||
actionMethod | Méthode d’envoi .Retourne une valeur POST ou GET. Post par défaut. | ||
pareqFieldName | Nom du champ “Pareq à Poster | ||
pareqFieldValue** | Contient la Valeur du champ PaReq | ||
termurlFieldName | Contient le nom du champ "TermUrl" à Poster | ||
termurlFieldValue** | Contient la valeur du champ "TermUrl" |
* nom de l'alias donné au contrat VAD du moyen de paiement
** Attention ces valeurs sont générés de manière dynamique et se renouvelleront pour chaque message.
2. 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
Les paramètres sont indiqués par les champs et les valeurs dynamiquement :
pareqFieldName | nom du paremètre |
pareqFieldValue | valeur du paramètre pareqFieldName |
termUrlName | nom du paremètre |
termUrlValue | valeur du paramètre termUrlName |
midFieldName | nom du paremètre |
midFieldName | valeur du paramètre midFieldName |
3. La demande de paiement avec le service doAuthorisation
Vous devez récupérer les informlations MD en retour de l'authentification 3DS pour réaliser la demande de paiement :
doAuthorisation | |
---|---|
result.code | 00000 |
result.shortmessage | ACCPTED |
result.longmessage | Transaction approved |
token | 1gZKPUeSufwDtQkVo3071534757637648 |
redirectURL | https://homologation-webpayment.payline.com/webpayment/step1.do?reqCode=prepareStep1&token=1gZKPUeSufwDtQkVo3071534757637648 |
* nom de l'alias donné au contrat VAD du moyen de paiement
4. Récupération du détail de la transaction avec le service getTransactionDetail
Demande de paiement 3DS | |
---|---|
getTransactionDetail | |
result.code | 00000 |
result.shortmessage | ACCPTED |
result.longmessage | Transaction approved |
token | 1gZKPUeSufwDtQkVo3071534757637648 |
redirectURL | https://homologation-webpayment.payline.com/webpayment/step1.do?reqCode=prepareStep1&token=1gZKPUeSufwDtQkVo3071534757637648 |