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.

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

lbox
tbstyle	undefined
diagramDisplayName	Diagramme Paiement 3DS Direct V2

width

true

1254

contentVer

links

16

undefined

height

tbstyle

482

undefined

revision

height

16

Les étapes : 422

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

Les services de l'API

Volet

Développer

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

VerifyEnrollment

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

Exemple de configuration :

verifyEnrollment
verifyEnrollmentRequest		verifyEnrollmentResponse
Eléments	Valeurs	Eléments	Valeurs

RequestResponse


version	18	version	18
card

Information sur la carte.

.number	497010XXXXXX1646	result

Informations sur le résultat de la vérification d'enrollement :

00000 : Transaction approved
01xxx : Transaction refused
021xx : Internal Error

paymentInformation sur le paiement.mdFieldNameContient le nom du champ "MD field"orderRefL’identifiant de la commande chez le commerçant.mdFieldValueContient la valeur du champ "MD field" à PostermdFieldValueValeur du merchantData (Cette valeur doit être unique). L’utilisation de champ n’est pas recommandée.ActionUrl URL de l’ACSuserAgentUserAgent du terminal de paiement. Pour connaitre l’origine de la demande de paiement, il sera transmis lors de la demande 3DS au MPI.actionMethodMé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.pareqFieldNameNom du champ “Pareq à PosterwalletCardIndL’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.pareqFieldValueContient la Valeur du champ PaReqgenerateVirtualCvxDemande de génération d’un CVV virtuel.
Vérifier si votre abonnement permet cette fonctionnalité (Tokenization).termurlFieldNameContient le nom du champ "TermUrl" à PostermerchantNameNom affiché sur la page d'authentification de l'ACS.termurlFieldValueContient la valeur du champ "TermUrl"

.code	03000
card.expirationDate	1222	result.shortMessage	ACCEPTED
card.cvx	123	result.longMessage	Transaction accepted
payment.amount	10000	termurlName*	TermUrl
payment.action	101	termurlValue*	NULL
payment.mode	CPT	mdFieldName*	MD
payment.contractNumber	VAD3DS	mdFieldValue*	2KJw5rL1N7pZRsfS8Xiw
orderRef	PHP1544091439	pareqFieldName*	PaReq
		pareqFieldValue*	eJxVkW9vgjAQxr+K8QPQ8k/AnE10bJlZ1MXpsr0yTbkMohQsMMVPvxZxbq96v+fa691zsEkVYvyGolHIYIFVxb9wkCWT..
		actionMethod	POST
		ActionUrl	https://3ds-acs.test.modirum.com/mdpayacs/pareq
		token	4970zSIkspmH5670

* Attention les

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

Volet

Développer

title	2. 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.

Les paramètres sont indiqués par les champs et les valeurs dynamiquement : à chaque appel, ils peuvent être modifiés.

pareqFieldName	nom du

paremètre

paramètre
pareqFieldValue	valeur du paramètre pareqFieldName
termUrlName	nom du

paremètre

paramètre
termUrlValue	valeur du paramètre termUrlName
midFieldName	nom du

paremètre

paramètre
midFieldName	valeur du paramètre midFieldName

Volet

Développer

title	3. 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
Request		Response
version		result.code	00000
payment.amount		result.shortmessage	ACCPTED
payment.action	101	result.longmessage	Transaction 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.mode	CPT	transaction.id	28340115745009
payment.contractNumber	VAD3DS	transaction.date	07/04/2018 11:27:45
card.number	4970100012345670	authorization.number	ACCOR0
card.expirationDate	1222	authorization.date	07/04/2018 11:27:45
card.cvx	123	card.number	497010XXXXXX5670
order.ref	PHP1544091439	card.type	CB
buyer.customerId	ID12654895	card.expirationDate	1222
3DSecure.md	2KJw5rL1N7pZRsfS8Xiw	card.token	4970zSIkspmH5670
3DSecure.pares	eJxVkW9vgjAQxr+K8QPQ8k/AnE10bJlZ1MXpsr0yTbkMohQsMMVPvxZxbq96v+fa691zsEkVYvyGolHIYIFVxb9wkCWT..	contractNumber	VAD3DS

Volet

Développer

title	4. 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
Request		Response
transactionId	28340115745009

getTransactionDetail

	result.code	00000
orderRef	PHP1544091439	result.shortmessage	ACCPTED
version	18	result.longmessage	Transaction 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

Arborescence des pages

Comparaison des versions

Ancienne version 19

Nouvelle version Actuel

Légende

Paiement 3DS en direct

Intégration

Les services de l'API

getTransactionDetails

Exemple du centre administration

Arborescence des pages

Historique de la page

Comparaison des versions

Ancienne version 19

Nouvelle version Actuel

Légende

Paiement 3DS en direct

Intégration

Les services de l'API

getTransactionDetails

Exemple du centre administration