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 NameField LengthDescriptionInclusion
panNumber 13-19The 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=="
  }
]