Request Method :: POST

Description:

  • Your organization will provide us a Call-back URL with the following configurations
  • The Call-back URL should be of Method Type POST
  • Content-type should be of Type application/JSON
  • The Call-back URL should have the below request format.

 
Note : This is a Server to Server API call.

Headers

Content-Type: application/json

Request Body Parameters

Parameters Max Length Data types Mandatory/Optional/Conditional Parameter Description
threeDSServerTransID 36 String Mandatory Unique transaction identifier assigned by the 3DS Server. e.g.- adafd242 bdfc-4628-8dbd-16576e8351e1
acsTransID 36 String Mandatory Unique transaction identifier assigned by the Access Control Server (ACS). e.g.- 9e5fef5b-6eb1-4abb-b10c f2fa863b6f38
authcTxnId 19 String Mandatory Authentication transaction ID from the system. e.g.- 1302
orderId 20 String Mandatory Merchant’s unique order ID.e.g.- 78678678687
acsRenderingType - Object Mandatory ACS Rendering Type
acsInterface 2 String Mandatory (if acsRendering Type is present) Type of ACS interface for challenge display (01 = Native, 02 = HTML).
acsUiTemplate 2 String Mandatory (if acsRendering Type is present) ACS UI template type. e.g.-01
authenticationMethod 2 String Optional Method used for authentication.(10 = OTP,11 = Biometric, etc.)
authenticationType 2 String Mandatory (if acsRendering Type is present) Type of authentication performed. (01 = Frictionless, 04 = Challenge, etc.)
authenticationValue 28 String(Base64/Text) Mandatory (if acsRendering Type is present) Authentication value provided byACS. e.g.- ABC123XYZ
challengeCancel 2 String Optional Indicates reason for challenge cancellation (01 = User Canceled, 06 = Transaction Abandoned, etc.).
dsTransID 36 String Mandatory Unique transaction ID assigned by the Directory Server (DS).e.g.-51e4365d-b98d-4dbd-a740 a8302ff7b266
eci 2 String Mandatory Electronic Commerce Indicator (authentication result; 05 = Fully Authenticated, 07 = Attempt).
messageCategory 2 String Mandatory Identifies the message category (01 = PA, 02 = NPA).
messageExtension - String(Base64/Text) Optional Field reserved for additional information or extensions.
messageType 3 String Mandatory Type of message (RReq = Result Request).e.g.- RReq
messageVersion 5 String Mandatory 3DS Protocol version being used.e.g.-2.2.0
sdkTransID 36 String Mandatory Unique transaction ID generated by the 3DS SDK to track the authentication process across the device, ACS, and 3DS Server.
transStatus 50 String Optional Transaction status (Y = Authenticated, N = Not Authenticated, C = Challenge Required, etc.)
transStatusReason 50 String Optional Reason code or description for the given transaction status.e.g.- CardHolder Authenticated
whiteListStatus 1 String Optional Indicates cardholder’s whitelist status with issuer (Y = Yes, N = No).
whiteListStatusSource 20 String Optional Source of whitelist status information (Issuer/Directory Server).
authcTxnId 19 String Mandatory Unique authentication transaction ID. e.g.- 2025080615110352359
orderId 20 String Mandatory Unique order ID for transaction.e.g. 1361

Sample Request Body