3ds authentication flow

Securityapi_key
Request
Request Body schema: application/json
threeDSCompInd
required
string = 1 characters
Enum: "Y" "N" "U"
threeDSRequestorAuthenticationInd
required
string = 2 characters
Enum: "01" "02" "03" "04" "05" "06"
object
threeDSRequestorChallengeInd
string = 2 characters
Enum: "01" "02" "03" "04" "05" "06" "07" "08" "09"
threeDSRequestorDecMaxTime
string = 5 characters
threeDSRequestorDecReqInd
string = 1 characters
Enum: "Y" "N"
threeDSRequestorID
required
string <= 35 characters
threeDSRequestorName
required
string <= 40 characters
object
threeDSRequestorURL
required
string <= 2048 characters
threeDSServerTransID
required
string = 36 characters
acctType
string
Enum: "01" "02" "03"
acquirerMerchantID
string <= 35 characters
addrMatch
string = 1 characters
Enum: "Y" "N"
object
browserAcceptHeader
string
browserIP
string
browserJavaEnabled
boolean
browserJavascriptEnabled
boolean
browserLanguage
string
browserColorDepth
string
Enum: "1 bits" "4 bits" "8 bits" "15 bits" "16 bits" "24 bits" "32 bits" "48 bits"
browserScreenHeight
string [ 1 .. 6 ] characters
browserScreenWidth
string [ 1 .. 6 ] characters
browserTZ
string [ 1 .. 5 ] characters
browserUserAgent
string <= 2048 characters
cardExpiryDate
string = 4 characters
object
acctID
string <= 64 characters
billAddrCity
string <= 50 characters
billAddrCountry
string <= 50 characters
billAddrLine1
string <= 50 characters
billAddrLine2
string <= 50 characters
billAddrLine3
string <= 50 characters
billAddrPostCode
string <= 16 characters
billAddrState
string <= 3 characters
email
string <= 254 characters
object
object
cardholderName
string [ 2 .. 45 ] characters
shipAddrCity
string <= 50 characters
shipAddrCountry
string = 3 characters
shipAddrLine1
string <= 50 characters
shipAddrLine2
string <= 50 characters
shipAddrLine3
string <= 50 characters
shipAddrPostCode
string <= 16 characters
shipAddrState
string <= 3 characters
object
deviceChannel
required
string
Value: "02"
payTokenInd
string
payTokenSource
string
purchaseInstalData
string <= 3 characters
mcc
string = 4 characters
merchantCountryCode
string = 3 characters
merchantName
string <= 40 characters
object
messageCategory
required
string
Enum: "01" "02"
Array of objects
messageType
required
string = 4 characters
messageVersion
required
string [ 5 .. 8 ] characters
purchaseAmount
string <= 48 characters
purchaseCurrency
string = 3 characters
purchaseExponent
string = 1 characters
purchaseDate
string
recurringExpiry
string = 8 characters
recurringFrequency
string <= 4 characters
transType
string
Enum: "01" "03" "10" "11" "28"
whiteListStatus
string
Enum: "Y" "N" "E" "P" "R" "U"
whiteListStatusSource
string
Enum: "01" "02" "03"
challengeWindowSize
required
string
Enum: "01" "02" " 03" "04" "05"
Responses
200

Successful response.

400

Invalid Request

401

Invalid API key.

403

Forbidden from performing this action.

500
post/online/v1/payment/3ds2/authenticate
Request samples
application/json
{
  • "deviceChannel": "02",
  • "messageCategory": null,
  • "messageType": "AReq",
  • "messageVersion": "2.2.0",
  • "threeDSCompInd": "Y",
  • "threeDSRequestorAuthenticationInd": "01",
  • "threeDSRequestorID": "",
  • "threeDSRequestorName": "",
  • "threeDSRequestorURL": "merchantcheckout.com",
  • "threeDSServerTransID": "cfdab65d-2374-9a40-9e13-fbb4c8325ac7",
  • "challengeWindowSize": "03"
}
Response samples
application/json
{
  • "transactionReceipt": "string",
  • "payment": {
    },
  • "authenticationResponse": {
    },
  • "result": {
    }
}