Content

Sommaire

maxLevel	2
style	none

3DS Payment in direct mode

3D Secure payment is done in two steps:

Card enrollment verification to 3D Secure system and authentication.
Payment request.

Integration

You must use verifyEnrollment and doAuthorization web services of the Payline API.

Diagramme draw.io

baseUrl	https://payline.atlassian.net/wiki
diagramName	Untitled Diagram.drawio
width	1254
contentId	15859064991580204925
zoom	1
simple	0
pageId	1414692917
lbox	1
diagramDisplayName	Diagram transaction 3DS EN
contentVer	1
height	478
revision	2

Steps :

The consumer validates his cart shopping and fill the payment data to check enrollment by merchand request;
The merchant redirects the consumer to the bank's authentication page;
The merchant can then make a payment request with the authentication information with service doAuthorization;
The merchant must retrieve transaction information with the getTransactionDetails service.

API services

Volet

Développer

title	1. Verification Request for Card Enrollment with VerifyEnrollment Service

You must first request verification of credit card registration with Payline with verifyEnrollement service:

verifyEnrollment
Request		Response
version	18	version	18
card.number	497010XXXXXX1646	result.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

* Values are generated dynamically and will be renewed for each request.

Volet

Développer

title	2. Consumer Redirection for Authentication

You must fulfill the consumer's 3DS authentication request.

To do it, you must redirect the consumer to ActionUrl URL with the parameters that you find in verifyEnrollementResponse service.

Check the method used POST or GET of actionMethod.

in POST you post a method form with fields names and values , adding the termUrl on which the user will be redirected;
in GET you will be able to transmit the names and the values in URL parameters.

The parameters are indicated by fields and values dynamically: with each call, they can be modified.

pareqFieldName	parameter name
pareqFieldValue	parameter value pareqFieldName
termUrlName	parameter name
termUrlValue	parameter value termUrlName
midFieldName	parameter name
midFieldName	parameter value midFieldName

Volet

Développer

title	3. The payment request with the service doAuthorization

You must retrieve MD information and pares back from 3DS authentication to transmit them in payment request to Payline:

doAuthorization
Request		Response
version		result.code	00000
payment.amount		result.shortmessage	ACCPTED
payment.action	101	result.longmessage	Transaction approved
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. Retrieving the details of the transaction with the service getTransactionDetails

You must retrieve all information by calling getTransactionDetails service:

getTransactionDetails
Request		Response
transactionId	28340115745009	result.code	00000
orderRef	PHP1544091439	result.shortmessage	ACCPTED
version	18	result.longmessage	Transaction approved
		transaction...	..
		payment...	..
		authorization..	..
		order...	..
		buyer...	..

Back Office example

Example of transaction detail screen

Arborescence des pages

Comparaison des versions

Ancienne version 10

Nouvelle version 11

Légende

3DS Payment in direct mode

Integration

API services

getTransactionDetails

Back Office example

Arborescence des pages

Historique de la page

Comparaison des versions

Ancienne version 10

Nouvelle version 11

Légende

3DS Payment in direct mode

Integration

API services

getTransactionDetails

Back Office example