Contenu
Sommaire | ||||
---|---|---|---|---|
|
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 | ||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
- Le consommateur valide son panier et renseigne ses données de paiement afin que Payline vérifie l'authentification de la carte auprès de l'annuaire des cartes déclarées "enrollées".
- Après vérification de l'enrollement, le consommateur sera redirigé vers une page web où il pourra finaliser son authentification avec le code qui lui aura été transmis par SMS.
- Enfin, une demande d’autorisation et de validation de paiement sera envoyée.
- La réponse à cette demande finalisera la transaction.
1. Demande de vérification de l'enrollement de la carte avec le service VerifyEnrollment
VerifyEnrollment | |||
---|---|---|---|
Request | Response | ||
version | 18 | version | 18 |
card | Information sur la carte. | result | Informations sur le résultat de la vérification d'enrollement : 00000 : Transaction approved |
payment | Information sur le paiement. | mdFieldName | Contient le nom du champ "MD field" |
orderRef | L’identifiant de la commande chez le commerçant. | mdFieldValue** | Contient la valeur du champ "MD field" à Poster |
mdFieldValue | Valeur du merchantData (Cette valeur doit être unique). L’utilisation de champ n’est pas recommandée. | ActionUrl** | URL de l’ACS |
userAgent | UserAgent du terminal de paiement. Pour connaitre l’origine de la demande de paiement, il sera transmis lors de la demande 3DS au MPI. | actionMethod | Méthode d’envoi .Retourne une valeur POST ou GET. Post par défaut. |
walletId | L’identifiant du portefeuille de l’acheteur. La balise version doit être remplie avec la valeur égale ou supérieure à 10. | pareqFieldName | Nom du champ “Pareq à Poster |
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. | pareqFieldValue** | Contient la Valeur du champ PaReq |
generateVirtualCvx | Demande de génération d’un CVV virtuel. Vérifier si votre abonnement permet cette fonctionnalité (Tokenization). | termurlFieldName | Contient le nom du champ "TermUrl" à Poster |
merchantName | Nom affiché sur la page d'authentification de l'ACS. | 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 |