Contenu

Sommaire

maxLevel	2
style	none

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

contentId	1129578826
zoom	1
pageId	1121355152
diagramDisplayName	Diagramme Paiement 3DS Direct V2
lbox	1
contentVer	1113
revision	1113
baseUrl	https://payline.atlassian.net/wiki
diagramName	Diagramme Paiement 3DS Direct
width	1254
links	undefined
tbstyle	undefined
height	422501

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

payment
.number	497010XXXXXX1646	result	Informations sur le résultat de la vérification d'enrollement : 00000 : Transaction approved 01xxx : Transaction refused 021xx : Internal Error
card.expirationDate	1222
card.cvx	123

Information sur le paiement.

orderRef
.amount	10000	mdFieldName	Contient le nom du champ "MD field"
payment.contractNumber	VAD3DS

L’identifiant de la commande chez le commerçant.

REF00021	mdFieldValue**	Contient la valeur du champ "MD field" à Poster

mdFieldValueValeur du merchantData (Cette valeur doit être unique). L’utilisation de champ n’est pas recommandée.


		ActionUrl**	URL de l’ACS

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

walletIdL’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

walletCardIndL’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

generateVirtualCvxDemande 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

merchantNameNom 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

Arborescence des pages

Comparaison des versions

Ancienne version 20

Nouvelle version 21

Légende

CU10 - Paiement 3DS en direct

Le principe

Intégration

1. Demande de vérification de l'enrollement de la carte avec le service VerifyEnrollment

2. Redirection du consommateur pour l'authentification

3. La demande de paiement avec le service doAuthorisation

4. Récupération du détail de la transaction avec le service getTransactionDetail

getTransactionDetail

Exemple du centre administration

Arborescence des pages

Historique de la page

Comparaison des versions

Ancienne version 20

Nouvelle version 21

Légende

CU10 - Paiement 3DS en direct

Le principe

Intégration

1. Demande de vérification de l'enrollement de la carte avec le service VerifyEnrollment

2. Redirection du consommateur pour l'authentification

3. La demande de paiement avec le service doAuthorisation

4. Récupération du détail de la transaction avec le service getTransactionDetail

getTransactionDetail

Exemple du centre administration