• France
status page
Demo shops
assistance
FAQContact support
Search
Categories
Tags
docs.
France
Spain
Europe (English)
India
Homepage
Use cases
Create a payment
Create an installment payment
Create a multi-card (split) payment
Create a payment by Alias (Token)
Create a payment link
Create a recurring payment
Manage subscriptions
Manage your transactions (refund, cancel...)
Analyze your reports
API docs
Embedded Form
REST API
Hosted payment
Mobile payment
File exchange
SDD mandates by REST API
Snippets
Payment methods
Plugins
Marketplace
Guides
Merchant Back Office
Back Office Expert
Functional guides

3DS1 - Authentication completed (SUCCESS or FAILED)

To test this scenario, use one of the card numbers below:

CARD Expiry date Label
4970100000000022 To be chosen Visa
5970100300000026 To be chosen mastercard
378283000000002 To be chosen Amex

When entering the authentication code, type:

  • The expected code, to obtain a successful authentication.
  • A wrong code, to obtain a failed authentication.

Exchange flow

1. Initial call to the PCI/Charge/Authenticate service with a card enrolled for 3DS1.

{
  "amount": "9990",
  "currency": "EUR",
  "transactionCategory": "PAYMENT",
  "productType": "GOODS_OR_SERVICE_PURCHASE",
  "merchant": {
    "mid": "9876357"
  },
  "paymentForm": {
    "expiryMonth": "09",
    "expiryYear": "22",
    "networkPreference": "VISA",
    "pan": "4970100000000022"
  },
  "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": "1",
	"challengePreference": "NO_PREFERENCE"
  }
}

2. A return with a CHALLENGE instruction of redirection to the ACS with a paReq (visible iFrame).

{
	"webService":"PCI/Charge/Authenticate",
	"version":"V4",
	"applicationVersion":"5.23.0",
	"serverDate":"2021-05-05T06:44:46+00:00",
	"ticket":"a983c631193f4777b342772777085c6f",
	"applicationProvider":"",
	"metadata":null,
	"status":"SUCCESS",
	"mode":"TEST",
	"serverUrl":"",
	"_type":"V4/WebService/Response",
	"answer":{
		"id":"a30802af-24e3-4071-8e07-331bfbc40cfa",
		"protocol":{
			"name":"THREEDS",
			"version":"1.0.2",
			"network":"VISA",
			"challengePreference":"NO_PREFERENCE",
			"simulation":true,
			"_type":"V4/Charge/Authenticate/Protocol"
		},
		"value":{
			"instructionType":"FORM",
			"name":"CHALLENGE",
			"timeout":600,
			"target":{
				"element":"IFRAME",
				"visible":true,
				"width":390,
				"height":467,
				"_type":"V4/Charge/Authenticate/InstructionTarget"
			},
			"http":{
				"method":"POST",
				"url":"https://acs.sg.com/1.0.2/acs/v1/interactive_authenticate",
				"body":{
					"MD":"H4sIAAAAAAAAAEVRyb...",
					"PaReq":"eJxVUtty2jAQ/RW...",					
					"TermUrl":"https://pass.sample-acs.net/public/v1/3dsv1/notify/.../VISA"
				},
				"_type":"V4/Charge/Authenticate/HttpRequest"
			},
			"_type":"V4/Charge/Authenticate/AuthenticationInstruction"
		},"_type":"V4/AuthenticationResponseData"
	}
}

3. Redirection to the ACS in the iFrame, cardholder authentication.

The characteristics of the Iframe are given in the answer.value.target object. The form to be displayed in the Iframe is described in the answer.value.http object.

4. Return via the browser with an instruction result.

{
	"eventName":"LYRA_AUTH_INSTRUCTION_RESULT",
	"value":{
		"name":"CHALLENGE",
		"value":"eyJjZXJ0aWZpY2F0ZSI...",
		"protocol":{
			"name":"THREEDS",
			"version":"1.0.2",
			"network":"VISA",
			"challengePreference":"NO_PREFERENCE",
			"simulation":true
		}
	}
}

5. A new call to the PCI/Charge/Authenticate service transmitting this result.

{
  "amount": "9990",
  "currency": "EUR",
  "transactionCategory": "PAYMENT",
  "productType": "GOODS_OR_SERVICE_PURCHASE",
  "merchant": {
    "mid": "9876357"
  },
  "paymentForm": {
    "expiryMonth": "09",
    "expiryYear": "22",
    "networkPreference": "VISA",
    "pan": "4970100000000022"
  },
  "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": "1",
    "challengePreference": "NO_PREFERENCE"
  },
  "id":"a30802af-24e3-4071-8e07-331bfbc40cfa",
  "instructionResult": {
    "name" : "CHALLENGE",			
    "protocol" : {
		"name" : "THREEDS",
		"network": "VISA",
		"version" : "1.0.2",
		"challengePreference": "NO_PREFERENCE",
		"simulation": 1
    },
    "value":"eyJjZXJ0aWZpY2F0ZSI..."
  }		  
}

6. Answer of the payment gateway server with the final authentication result.

Successful authentication.

{
	"webService":"PCI/Charge/Authenticate",
	"version":"V4",
	"applicationVersion":"5.23.0",
	"serverDate":"2021-05-05T06:45:49+00:00",
	"ticket":"a983c631193f4777b342772777085c6f",
	"applicationProvider":"",
	"metadata":null,
	"status":"SUCCESS",
	"mode":"TEST",
	"serverUrl":"",
	"_type":"V4/WebService/Response",
	"answer":{
		"id":"a30802af-24e3-4071-8e07-331bfbc40cfa",
		"protocol":{
			"name":"THREEDS",
			"version":"1.0.2",
			"network":"VISA",
			"challengePreference":"NO_PREFERENCE",
			"simulation":true,
			"_type":"V4/Charge/Authenticate/Protocol"
		},
		"value":{
			"authenticationType":"CHALLENGE",
			"authenticationId":{
				"authenticationIdType":"xid",
				"value":"SGJSVVNmRmljVVRGU0RnRTRDQ2g=",
				"_type":"V4/Charge/Authenticate/AuthenticationId"
			},
			"authenticationValue":{
				"authenticationValueType":"CAVV",
				"value":"Q2F2dkNhdnZDYXZ2Q2F2dkNhdnY=",
				"_type":"V4/Charge/Authenticate/AuthenticationValue"
			},
			"status":"SUCCESS",
			"commerceIndicator":"05",
			"extension":{
				"authenticationType":"THREEDS_V1",
				"enrolled":"Y",
				"algorithmName":"CVV_ATN",
				"algorithm":"2",
				"signatureValid":true,
				"_type":"V4/Charge/Authenticate/AuthenticationResultExtensionThreedsV1"
			},
			"_type":"V4/Charge/Authenticate/AuthenticationResult"
		},
		"_type":"V4/AuthenticationResponseData"				
	}
}

Failed authentication

{
	"webService":"PCI/Charge/Authenticate",
	"version":"V4",
	"applicationVersion":"5.23.0",
	"serverDate":"2021-05-05T06:45:49+00:00",
	"ticket":"a983c631193f4777b342772777085c6f",
	"applicationProvider":"",
	"metadata":null,
	"status":"SUCCESS",
	"mode":"TEST",
	"serverUrl":"",
	"_type":"V4/WebService/Response",
	"answer":{
		"id":"a30802af-24e3-4071-8e07-331bfbc40cfa",
		"protocol":{
			"name":"THREEDS",
			"version":"1.0.2",
			"network":"VISA",
			"challengePreference":"NO_PREFERENCE",
			"simulation":true,
			"_type":"V4/Charge/Authenticate/Protocol"
		},
		"value":{
			"authenticationType":"CHALLENGE",
			"authenticationId":{
				"authenticationIdType":"xid",
				"value":"WkJld1pYd25lRUxwY2R1U0Jtd2c=",
				"_type":"V4/Charge/Authenticate/AuthenticationId"
			},
			"status":"FAILED",
			"commerceIndicator":"06",
			"extension":{
				"authenticationType":"THREEDS_V1",
				"enrolled":"Y",
				"signatureValid":true,
				"_type":"V4/Charge/Authenticate/AuthenticationResultExtensionThreedsV1"
			},
			"reason":{
				"code":"REJECTED",
				"_type":"V4/Charge/Authenticate/AuthenticationResultReason"
			},
			"_type":"V4/Charge/Authenticate/AuthenticationResult"
		},
		"_type":"V4/AuthenticationResponseData"
	}
}
Jobs
Legal
GDPR
25.20-1.11