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 | termurlFieldName | Contient le nom du champ "TermUrl" à Poster. |
card.cvx | 123 | termurlFieldValue** | Contient la valeur du champ "TermUrl". |
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. |
walletId | L’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. |
walletCardInd | L’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. | actionMethod | Méthode d’envoi .Retourne une valeur POST ou GET. Post par défaut. |
generateVirtualCvx | Demande de génération d’un CVV virtuel. Vérifier si votre abonnement permet cette fonctionnalité (Tokenization). | pareqFieldName | Nom du champ “Pareq à Poster. |
merchantName | Nom affiché sur la page d'authentification de l'ACS | pareqFieldValue** | Contient la Valeur du champ PaReq. |
* 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 |