***Changes made on 04/11/2019 are delineated below in Red.***
Authenticate Request/Response Messages Updated with EMV® 3-D Secure Protocol v2.2.0 Fields
Field Name | Description | Required | Field Definition |
---|---|---|---|
No New Changes | |||
3DS Extension Support | |||
IVR Extensions (India Only) | |||
No New Changes |
cmpi_authenticate Response Message
This message is generated in response to the cmpi_authenticate request message.
TIP:
- All fields use ASCII character set (0-9, A-Z, a-z, special characters $%&@!_ etc.)
- The required field contains one of the following values
- Y = Yes (Required field)
- C = Conditional (Conditions of transaction determine if this field will be returned or not)
- O = Optional (Not required but highly recommended)
- N = No (Not required)
- Boolean = True or False
Field Name | Description | Required | Field Definition |
---|---|---|---|
ThreeDSVersion | This field contains the 3DS version that was used to process the transaction. Possible Values: 1.0.2 2.1.0 2.2.0 | Y | AN(10) |
3DS 2.0 Fields
Field Name | Description | Required | Condition | Field Definition | ||||||
---|---|---|---|---|---|---|---|---|---|---|
ChallengeCancel | An indicator as to why the transaction was canceled. Possible Values: 01 - Cardholder selected 'Cancel' 02 - 03 - 04 - Transaction timed out at ACS—other timeouts 05 - Transaction Timed out at ACS - First CReq not received by ACS 06 - Transaction Error 07 - Unknown 08 = Transaction Timed Out at SDK NOTE: Only present when the Consumer cancels the challenge. Decoupled authentication is not supported at this time. | C | Merchant Configuration ON Required in CReq for 01-APP if the authentication transaction was canceled by user interaction with the cancelation button in the UI or for other reasons as indicated. Required in the RReq if the ACS identifies that the authentication transaction was canceled for reasons as indicated. Value of 04 or 05 is required when Transaction Status Reason = 14. | N(2) | ||||||
ACSRenderingType | Identifies the UI Type the ACS will use to complete the challenge. NOTE: Only available for App transactions using the Cardinal Mobile SDK. Decoupled authentication is not supported at this time. | C | Merchant Configuration ON & App For RReq, required unless ACS Decoupled Confirmation = Y. | |||||||
AuthenticationType | Indicates the type of authentication that will be used to challenge the card holder. Possible Values: 01 - Static 02 - Dynamic 03 - OOB (Out of Band) 04 - Decoupled NOTE: EMV® 3-D Secure version 2.1.0 supports values 01-03. Version 2.2.0 supports values 01-04. Decoupled authentication is not supported at this time. | C | Merchant Configuration ON Required in the RReq message if the Transaction Status = Y or N in the RReq message. | N(2) | ||||||
SdkTransID
| SDK unique transaction identifier that is generated on each new transaction. | R | AN(36) | |||||||
WhiteListStatus
| Enables the communication of trusted beneficiary/whitelist status between the ACS, the DS and the 3DS Requestor. Possible Values: Y - 3DS Requestor is whitelisted by cardholder N - 3DS Requestor is not whitelisted by cardholder E - Not eligible as determined by issuer P - Pending confirmation by cardholder R - Cardholder rejected U - Whitelist status unknown, unavailable, or does not apply | O | AN(1) | |||||||
WhiteListStatusSource
| This data element will be populated by the system setting Whitelist Status. Possible Values: 01 - 3DS Server 02 - DS 03 - ACS 04-79 - Reserved for EMVCo future use (values invalid until defined by EMVCo) 80-99 - Reserved for DS use | C | Required if Whitelist Status is present. | N(2) |