Inquiry Card Range from 3DS Server
Allows to check if the PAN is enrolled in 3DS2 or not by checking the card range cache in Hosted 3DSS which is updated during the PReq/PRes performed at an interval with the DS (minimum 1 hour and maximum 24 hours interval). It also allows if the issuer ACS supports the 3DS method (further information collecting) before performing the transaction for optimizing user experience purposes. If 3DS method is not supported, then the transaction will finish earlier since 3DS method will not be performed by the ACS.
Request
| Field Name | Field Length | Description | Inclusion |
|---|---|---|---|
| pan | Number 13-19 | The account number of the personal account number. (number 13-19) | R |
Response
| Field Name | Field Length | Description | Inclusion |
|---|---|---|---|
| dsStartVersion | varchar(8) | 2.2.0 | O |
| acsStartVersion | varchar(8) | 2.2.0 | O |
| dsEndVersion | varchar(8) | 2.2.1.0 | O |
| acsEndVersion | varchar(8) | 2.3.1.0 | O |
| acsInfoInd | varchar(2) | ACS Information Indicator
3DS Server obtains additional information from the ACS during the PReq/PRes process. The returned values describe the functions available on the ACS side.
Length: 2 characters JSON Data Type: Array of String Optional Values accepted: - 01 = Authentication Available at ACS - 02 = Attempts Supported by ACS or DS - 03 = Decoupled Authentication Supported - 04 = Whitelisting Supported - 80–99 = Reserved for future DS use | O |
| dsKey | varchar(256) | base64 encoded base64 encoded byte array, which will be used by the 3DS client to encrypt the deviceInfo | O |
| error | varchar(10) | Description of error in case of failed request. | O |
| threeDsMethodUrl | varchar(8) | SOMEURL | O |
| success | boolean | true - 3DS Server have range for PAN. false - 3DS Server doesn't have range for PAN. not included in failed message | R |
| dsName | varchar(10) | Possible values are: VISA MASTERCARD JCB AMEX UPI DISCOVER ITMX TPN | O |
| localDsName | varchar(10) | Possible values are: ITMX TPN | O |
Success Response for 2.2.0
[
{
"success": true,
"acsInfoInd": "01",
"threeDsMethodUrl": "<<someurl>>.com/3dsMethod",
"acsStartVersion": "2.1.0",
"acsEndVersion": "2.2.0",
"dsStartVersion": "2.1.0",
"dsEndVersion": "2.2.0",
"dsName": "ITMX",
"dsKey": "MIIBCgKCAQEAmKRH/GeGw54z0xH94w3UCaK5iI6GuoOakry2ycQwW4lvZOv4H52Y2HcCs6LwUfaQ\r\nnaeQiD8Y4IZviq7Bij+O9uOpuf7Vey/wZTgPDhWWplY5wgN7lNgSprsMNK9dFc/w/Xf1OaUYCLJyf\r\nJjjWiwJSojxajU3Ig5a/HyMavxkVVNO6S8qoWLpQN+po4jIiOtL4spn9gMd4LgD1W8igNVoQoMhy\r\nx1AXphO2uD0PZ0ZDqhWHFLFeb/VtVxaz0bBu27WbEl+KHjLRUSBWQi2QDTgWSmffCYrxtxVASsg2\r\nhieb7Nd2u90bXpN+tOlF07qrigGXzgSFLmsEL5oxTNzzmN8skQIDAQAB"
},
{
"success": true,
"acsInfoInd": "02",
"threeDsMethodUrl": "<<visaurl>>.com/3dsMethod",
"acsStartVersion": "2.1.0",
"acsEndVersion": "2.2.0",
"dsStartVersion": "2.1.0",
"dsEndVersion": "2.2.0",
"dsName": "VISA",
"dsKey": "MIIBCgKCAQEAmFh7aG4A5HyMBp4TkwC7dY9SO2P6Kh0EcrQ9Q0Y9y3G5F4G2F6TcJFF22M4TqEE\r\nMB2kAAjtkz4y3g4Q4DfpBltlfyH6Kb6yQlzsdF4MOlR1KnX0Dl7gN1Y5Pjf9R+H5XhK5O9SAwXp\r\n/Q=="
}
]
Updated 4 months ago