4.4. Decoupled Authentication
There are four different authentication flows in the 3-D Secure protocol. The decoupled authentication flow is one of them. The decoupled authentication flow is an asynchronous process.
The ACS can determine decoupled authentication fallback for an authentication transaction. If a fallback is determined, threeDSRequestorPriorAuthenticationInfo is required.
The requestor can set the TTL for the transaction by setting the threeDSRequestorDecMaxTime. The threeDSRequestorDecMaxTime accepts numeric values between 00001 and 10080 (7 days) which determines the TTL in minutes. We keep the transaction for threeDSRequestorDecMaxTime plus 60 minutes.
The requestor shall use the threeDSServerTransID to retrieve the authentication value by making a request towards the /postauth endpoint. Once we receive the authentication value from the ACS, we will only store it for 20 minutes. We therefore suggest that the requestor should poll the /postauth endpoint at least every 20 minutes. The authentication value is deleted when the TTL has passed.
If the 3-D Secure Server has not received the RReq message the following response will be returned:
1{
2 "errorCode": "305",
3 "errorComponent": "S",
4 "errorDescription": "No RReq has been received",
5 "errorDetail": "No response from directory server yet",
6 "messageType": "Erro",
7 "messageVersion": "2.2.0",
8 "threeDSServerTransID": "8700f0ef-0e96-471c-b107-1d2534f3f5a5"
9}
Testing in the sandbox
In the sandbox, use a browser authentication with an acctNumber ending in
83 to test decoupled authentication.
Decoupled authentication is only used if the AReq requests it. To request it, the AReq must have:
messageVersion2.2.0or greater.threeDSRequestorDecReqIndset toY. For2.3.1,Bis also accepted.threeDSRequestorDecMaxTimeset. Without it, the AReq is rejected with Erro201(required element missing).
The ACS then returns transStatus D, and completes the authentication with transStatus
Y after threeDSRequestorDecMaxTime minutes, at most 30.
If the AReq does not request decoupled authentication, the ACS falls back to a
challenge that automatically passes, as for an acctNumber ending in 70.
Decoupled authentication flow example
The following examples show AReq and ARes messages for a decoupled authentication flow.
1{
2 "acctNumber": "3000100811112083",
3 "cardExpiryDate": "2410",
4 "acquirerBIN": "868491",
5 "acquirerMerchantID": "mGm6AJZ1YotkJJmOk0fx",
6 "mcc": "5411",
7 "merchantCountryCode": "840",
8 "merchantName": "Dummy Merchant",
9 "threeDSRequestorDecReqInd": "Y",
10 "threeDSRequestorDecMaxTime": "00001",
11 "messageType": "AReq",
12 "messageVersion": "2.2.0",
13 "messageCategory": "01",
14 "deviceChannel": "02",
15 "transType": "01",
16 "threeDSRequestorAuthenticationInd": "01",
17 "threeDSRequestorID": "az0123456789",
18 "threeDSRequestorName": "Example Requestor name",
19 "threeDSRequestorURL": "https://threedsrequestor.adomainname.net",
20 "purchaseAmount": "101",
21 "purchaseCurrency": "840",
22 "purchaseExponent": "2",
23 "cardholderName": "Cardholder Name",
24 "email": "example@example.com",
25 "mobilePhone": {
26 "cc": "123",
27 "subscriber": "123456789"
28 },
29 "billAddrCity": "Bill City Name",
30 "billAddrCountry": "840",
31 "billAddrLine1": "Bill Address Line 1",
32 "billAddrPostCode": "Bill Post Code",
33 "billAddrState": "CO",
34 "shipAddrCity": "Ship City Name",
35 "shipAddrCountry": "840",
36 "shipAddrLine1": "Ship Address Line 1",
37 "shipAddrPostCode": "Ship Post Code",
38 "shipAddrState": "CO"
39 }
1{
2 "acsChallengeMandated": "Y",
3 "acsDecConInd": "Y",
4 "acsOperatorID": "3dsecureio-standin-acs",
5 "acsReferenceNumber": "3dsecureio-standin-acs",
6 "acsTransID": "fb95703f-92e7-4278-a20c-62b9a9200e84",
7 "authenticationType": "04",
8 "cardholderInfo": "01",
9 "dsReferenceNumber": "3dsecureio-standin-ds",
10 "dsTransID": "87cbe14f-5960-4a01-a0bb-ae2c9871804a",
11 "messageType": "ARes",
12 "messageVersion": "2.2.0",
13 "threeDSServerTransID": "5a8007b9-6d26-49cf-a371-3f722bba4ffc",
14 "transStatus": "D"
15 }
1{
2 "acsTransID": "fb95703f-92e7-4278-a20c-62b9a9200e84",
3 "authenticationType": "04",
4 "authenticationValue": "s3xYIbbZVSakGpUEaAtOfIt2Ohs=",
5 "dsTransID": "87cbe14f-5960-4a01-a0bb-ae2c9871804a",
6 "eci": "05",
7 "interactionCounter": "00",
8 "messageCategory": "01",
9 "messageType": "RReq",
10 "messageVersion": "2.2.0",
11 "threeDSServerTransID": "5a8007b9-6d26-49cf-a371-3f722bba4ffc",
12 "transStatus": "Y"
13}