payzen.eu
Rechercher
Catégories
Tags
France
France
Allemagne
Brésil
LATAM
Espagne
Europe (English)
Implémentation
Formulaire embarqué (client JavaScript)
APIs REST de paiement
Paiement par formulaire en redirection (avec ou sans iFrame)
Web Services
Échange de fichier
Formulaire de collecte de données
Paiement Mobile
Faciliter l'intégration
Modules de paiement gratuits
Exemples de code
Back office
Guides
Aide
FAQ
Tutoriels vidéos
Contacter le support

3DS2 - Authentification Frictionless, avec 3DS Method

Pour tester ce scénario, utilisez un des numéros de carte ci-dessous :

Carte Date de validité Marque
4970110000001029 Au choix VISA
5100010000000114 Au choix MASTERCARD
375900000010007 Au choix AMEX

Cinématique des échanges

1. Appel initial au service PCI/Charge/Authenticate avec une carte enrôlée 3DS2.

{
  "amount":"9990",
  "currency":"EUR",
  "transactionCategory":"PAYMENT",
  "productType":"GOODS_OR_SERVICE_PURCHASE",
  "merchant": {
    "mid":"9876357"
  },
  "paymentForm": {
    "expiryMonth":"09",
    "expiryYear":"22",
    "networkPreference":"VISA",
    "pan":"4970110000001029"
  },
  "device": {
    "acceptHeader":"text/html",
    "colorDepth":"32",
    "deviceType":"BROWSER",
    "ip":"69.89.31.226",
    "javaEnabled": true,
    "language":"FR",
    "screenHeight":"768",
    "screenWidth":"1258",
    "timeZoneOffset":"-120",
    "userAgent":"Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101"
  },
  "protocolRequest": {
    "name":"THREEDS",
    "version":"2",
	"challengePreference":"NO_PREFERENCE"
  }
}

2. Retour avec une instruction FINGERPRINT (3DS Method).

{
	"webService":"PCI/Charge/Authenticate",
	"version":"V4",
	"applicationVersion":"5.22.0",
	"serverDate":"2021-05-03T15:02:56+00:00",
	"ticket":"c295ad67f65341529c1db6760df400fd",
	"applicationProvider":"",
	"metadata":null,
	"status":"SUCCESS",
	"mode":"TEST",
	"serverUrl":"https://static.payzen.eu",
	"_type":"V4/WebService/Response",
	"answer":{
		"id":"b5bdf588-df35-4d56-8852-a68bd9c20147",
		"protocol":{
			"name":"THREEDS", "
			version":"2.1.0",
			"network":"VISA",
			"challengePreference":"NO_PREFERENCE",
			"simulation":true,
			"_type":"V4/Charge/Authenticate/Protocol"
		},
		"value":{
			"instructionType":"FORM",
			"name":"FINGERPRINT",
			"timeout":10,
			"target":{
				"element":"IFRAME",
				"visible":false,
				"_type":"V4/Charge/Authenticate/InstructionTarget"
			},
			"http":{
				"method":"POST",
				"url":"https://acs.sg.com/acs/v2/3dsMethod",
				"body":{
					"threeDSMethodData":"eyJ0aHJlZURzTW..."
				},									
				"_type":"V4/Charge/Authenticate/HttpRequest"
			},
			"_type":"V4/Charge/Authenticate/AuthenticationInstruction"
		},
		"_type":"V4/AuthenticationResponseData"
	}
}

3. Redirection vers l’ACS dans l’iFrame invisible, chargement et exécution du code JavaScript de fingerprint de l’ACS.

Les caractéristiques de l'Iframe sont données dans l'objet answer.value.target . Le formulaire à afficher dans l'Iframe est décrit dans l'objet answer.value.http .

4. Retour via le navigateur avec un résultat d’instruction.

{
	"eventName":"LYRA_AUTH_INSTRUCTION_RESULT",
	"value":{
		"name":"FINGERPRINT",
		"value":"eyJjZXJ0aWZpY2F0Z...",
	"protocol":{
		"name":"THREEDS",
		"version":"2.1.0",
		"network":"VISA",
		"challengePreference":"NO_PREFERENCE",
		"simulation":true
		}
	}
}

5. Nouvel appel au service PCI/Charge/Authenticate en transmettant ce résultat.

{
  "amount":"9990",
  "currency":"EUR",
  "transactionCategory":"PAYMENT",
  "productType":"GOODS_OR_SERVICE_PURCHASE",
  "merchant": {
    "mid":"9876357"
  },
  "paymentForm": {
    "expiryMonth":"09",
    "expiryYear":"22",
    "networkPreference":"VISA",
    "pan":"4970110000001029"
  },
  "device": {
    "acceptHeader":"text/html",
    "colorDepth":"32",
    "deviceType":"BROWSER",
    "ip":"69.89.31.226",
    "javaEnabled": true,
    "language":"FR",
    "screenHeight":"768",
    "screenWidth":"1258",
    "timeZoneOffset":"-120",
    "userAgent":"Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101"
  },
  "protocolRequest": {
    "name":"THREEDS",
    "version":"2",
	"challengePreference":"NO_PREFERENCE"
  },
  "id":"b5bdf588-df35-4d56-8852-a68bd9c20147",
  "instructionResult": {
    "name":"FINGERPRINT",			
    "protocol": {
		"name":"THREEDS",
		"network":"VISA",
		"version":"2.1.0",
		"challengePreference":"NO_PREFERENCE",
		"simulation": 1
    },
    "value":"eyJjZXJ0aWZpY2F0Z..."
  }
}

6. Retour du serveur de la plateforme de paiement avec le résultat final d’authentification.

{
	"webService":"PCI/Charge/Authenticate",
	"version":"V4",
	"applicationVersion":"5.22.0",
	"serverDate":"2021-05-03T15:02:58+00:00",
	"ticket":"c295ad67f65341529c1db6760df400fd",
	"applicationProvider":"",
	"metadata":null,
	"status":"SUCCESS",
	"mode":"TEST",
	"serverUrl":"https://static.payzen.eu",
	"_type":"V4/WebService/Response",
	"answer":{
		"id":"b5bdf588-df35-4d56-8852-a68bd9c20147",
		"protocol":{
			"name":"THREEDS",
			"version":"2.1.0",
			"network":"VISA",
			"challengePreference":"NO_PREFERENCE",
			"simulation":true, "_type":"V4/Charge/Authenticate/Protocol"
		},
		"value":{
			"authenticationType":"FRICTIONLESS",
			"authenticationId":{
				"authenticationIdType":"dsTransId",
				"value":"ff405f73-9b56-4cfc-b394-31a49beb4cac",
				"_type":"V4/Charge/Authenticate/AuthenticationId"
			},
			"authenticationValue":{
				"authenticationValueType":"CAVV",
				"value":"+kAr/o8S0DxgGYkz7QQHZCw8V5k=",
				"_type":"V4/Charge/Authenticate/AuthenticationValue"
			},
			"status":"SUCCESS",
			"commerceIndicator":"05",
			"extension":{
				"authenticationType":"THREEDS_V2",
				"threeDSServerTransID":"b5bdf588-df35-4d56-8852-a68bd9c20147",
				"dsTransID":"ff405f73-9b56-4cfc-b394-31a49beb4cac",
				"acsTransID":"1f1202cc-c578-4b3c-84ca-cd9fd79d09d0",
				"_type":"V4/Charge/Authenticate/AuthenticationResultExtensionThreedsV2"
			}, "reason":{
				"_type":"V4/Charge/Authenticate/AuthenticationResultReason"
			},
			"_type":"V4/Charge/Authenticate/AuthenticationResult"
		},
		"_type":"V4/AuthenticationResponseData"
	}
}

Head Office :

LYRA NETWORK
109, rue de l’innovation
31670 Labège
FRANCE

Nos services

Lyra
Recruitment
PayZen