3D Secure
3DS 2 Parameters
Request Parameters
Parameter |
Description |
Merchant ReturnUrl |
Mandatory: The URL which the Gateway will post return response parameters to |
ApplicationID |
Mandatory: Merchant Application ID generated upon the creation of the merchant profile on the iVeri Gateway |
MerchantReference |
Mandatory: A merchant generated identifier that is unique within a specified time that identifies a transaction sequence. |
Amount |
Mandatory: The total value of the transaction in the smallest unit of the currency specified (eg in cents) |
Currency |
Mandatory: The ISO 4217 currency code of the value of the transaction. e.g., USD or ZAR or GBP |
PAN |
Mandatory: Card number used for transaction |
ExpiryDate |
Mandatory: The last month of the validity period of the card, formatted as MMYY or MMYYYY |
CardSecurityCode |
The 3 or 4 digits printed on the card which are not contained on the magnetic strip. Usually printed after the Card number on the signature strip. Corresponds to American Express CIV, MasterCard CVC2 and VISA CVV2 |
Note: Depending on the result of 3D secure authentication, the following fields will be returned
Parameter |
Description |
ApplicationID |
Identification of the merchant profile performing the transaction |
MerchantReference |
|
Amount |
|
Currency |
|
JWT |
|
PAN |
|
ExpiryDate |
|
ResultCode |
|
ResultDescription |
|
ThreeDSecure_AuthenticationType |
Expected Value: 01 |
CardHolderAuthenticationID |
Commonly known XID: Unique identifier generated during the 3DS process |
CardHolderAuthenticationData |
|
ElectronicCommerceIndicator |
Commonly known as “ECI”: Indicates if the cardholder was fully authenticated, attempted or not. Possible values: ThreeDSecure (ECI “05”, “02”), ThreeDSecureAttempted (“ECI “06” or “01”) or SecureChannel (ECI “07”) |
ThreeDSecure_VEResEnrolled |
Possible values: Y|N|U - Indicates if the card is enrolled. |
ThreeDSecure_RequestID |
|
ThreeDSecure_ProtocolVersion |
Indicates the version of 3D secure used |
ThreeDSecure_DSTransID |
Directory Server Transaction ID returned for the transaction |