resultResponse
JSON object
resultResponse
Notice: Please note that all data elements listed below will be present in resultsResponse but might hold an empty string based on the condition.
Data elements
| Key | Format | CND | Description |
| threeDSServerTransID | string | M | 1cs Online Bezahlsystem PayID in canonical format as specified in IETF RFC 4122 |
| acsTransID | string | M | Universally Unique transaction identifier assigned by the ACS to identify a single transaction. |
| acsRenderingType | object | C | Required unless ACS Decoupled Confirmation = true |
| authenticationType | string | C | Required if the Transaction Status = Y or N. Indicates the type of authentication method the Issuer will use to challenge the cardholder. Required if the Transaction Status = C or D. Values accepted: 01 = static · 02 = dynamic · 03 = oobFuture implementation. Protocol Version 2.2.0 onwards – 04 = decoupled |
| authenticationValue | string | C | Required if Transaction Status = Y or A |
| challengeCancel | string | C | Indicator informing that the authentication has been canceled. Values accepted: · 01 = Cardholder selected “Cancel” · 02 = Reserved for future EMVCo use (values invalid until defined by EMVCo). · 03 = Transaction Timed Out—Decoupled Authentication · 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 |
| dsTransID | string | M | Universally unique transaction identifier assigned by the DS to identify a single transaction |
| eci | string | C | Payment System-specific value provided by the ACS or DS to indicate the results of the attempt to authenticate the Cardholder. The requirements for the presence of this field are DS specific. |
| interactionCounter | string | M | Indicates the number of authentication cycles attempted by the Cardholder. |
| messageCategory | string | M | Identifies the category of the message for a specific use case. Values accepted: · 01 = PA · 02 = NPA |
| messageExtension | string | C | Data necessary to support requirements not otherwise defined in the 3-D Secure message are carried in a Message Extension. Conditions to be set by each DS. |
| messageType | string | C | Identifies the type of message that failed in case of an error. Values accepted: · ARes · RReq |
| messageVersion | string | M | Protocol version identifier |
| sdkTransID | string | M | Future use. Universally unique transaction identifier assigned by the 3DS SDK to identify a single transaction. |
| transStatus | string | M | Indicates whether a transaction qualifies as an authenticated transaction. Values accepted: · Y = Authentication Verification Successful. · N = Not Authenticated /Account Not Verified; Transaction denied. · U = Authentication/ Account Verification Could Not Be Performed; Technical or other problem, as indicated in ARes or RReq. · A = Attempts Processing Performed; Not Authenticated/Verified, but a proof of attempted authentication/verification is provided. · C = Challenge Required; Additional authentication is required using the CReq/CRes. · D = Challenge Required; Decoupled Authentication confirmed. · R = Authentication/ Account Verification Rejected; Issuer is rejecting authentication/verification and request that authorisation not be attempted. · I = Informational Only; 3DS Requestor challenge preference acknowledged. |
| transStatusReason | string | C | Provides information on why the Transaction Status field has the specified value. Required if the Transaction Status field = N, U, or R. Values accepted: · 01 = Card authentication failed · 02 = Unknown Device · 03 = Unsupported Device · 04 = Exceeds authentication frequency limit · 05 = Expired card · 06 = Invalid card number · 07 = Invalid transaction · 08 = No Card record · 09 = Security failure · 10 = Stolen card · 11 = Suspected fraud · 12 = Transaction not permitted to cardholder · 13 = Cardholder not enrolled in service · 14 = Transaction timed out at the ACS · 15 = Low confidence · 16 = Medium confidence · 17 = High confidence · 18 = Very High confidence · 19 = Exceeds ACS maximum challenges · 20 = Non-Payment transaction not supported · 21 = 3RI transaction not supported · 22 = ACS technical issue · 23 = Decoupled Authentication required by ACS but not requested by 3DS Requestor · 24 = 3DS Requestor Decoupled Max Expiry Time exceeded · 25 = Decoupled Authentication was provided insufficient time to authenticate cardholder. ACS will not make attempt · 26 = Authentication attempted but not performed by the cardholder |
| whiteListStatus | string | C | Future use. Only supported with protocol version 2.2.0 onwards. Enables the communication of trusted beneficiary/whitelist status. Values accepted: · 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 |
| whiteListStatusSource | string | C | Future use. Only supported with protocol version 2.2.0 onwards. This data element will be populated by the system setting Whitelist Status. Values accepted: · 01 = 3DS Server (3-D Server) · 02 = DS (Directory Server) · 03 = ACS (Access Control Server) |
| dsScore | string | O | Directory Server (scheme) scoring result of the transaction during authentication. Format and value are DS specific. |
| challengeRequestInd | string | O | Merchant Challenge preference indicator, corresponding to “3DS Requestor Challenge Indicator” data element of EMVCo 3D-Secure v2.x specifications. Allowed values as per EMVCo 3D-Secure latest specifications: 2-digit value, 01-99: · 01 = No preference · 02 = No challenge requested · 03 = Challenge requested (3DS Requestor preference) · 04 = Challenge requested (Mandate) · 05 = No challenge requested (transactional risk analysis is already performed) · 06 = No challengerequested (Data share only) · 07 = No challenge requested (strong consumer authentication is already performed) · 08 = No challenge requested (utilise whitelist exemption if no challenge required) · 09 = Challenge requested (whitelist prompt requested if challenge required) · 10–79 = Reserved for EMVCo future use (values invalid until defined by EMVCo) · 80–99 = Reserved for DS use |
| cardholderInfo | string | O | Text provided by the ACS/Issuer to Cardholder during a Frictionless or Decoupled transaction. The Issuer can provide information to Cardholder. For example, “Additional authentication is needed for this transaction, please contact (Issuer Name) at xxx-xxx-xxxx.” Required if ACS Decoupled Confirmation Indicator = true Otherwise, Optional for the ACS. |
Schema
{
“$schema”: “http://json-schema.org/draft-07/schema#”,
“$id”: “https://www.computop-paygate.com/schemas/resultsResponse.json”,
“type”: “object”,
“properties”: {
“threeDSServerTransID”: {
“type”: “string”,
“maxLength”: 36
},
“acsTransID”: {
“type”: “string”,
“maxLength”: 36
},
“acsRenderingType”: {
“type”: “object”,
“properties”: {
“acsInterface”: {
“type”: “string”,
“enum”: [“native”, “html”, “”],
“description”: “Die ACS-Schnittstelle, die dem Karteninhaber die Challenge zeigen wird.”
},
“acsUiTemplate”: {
“type”: “string”,
“enum”: [“text”, “singleSelect”, “multiSelect”, “oob”, “other”,””],
“description”: “Bestimmt das Format der UI-Vorlage, die der ACS dem Kunden zuerst zeigt.”
}
},
“required”: [“acsInterface”, “acsUiTemplate”],
“additionalProperties”: false
},
“authenticationType”: {
“type”: “string”,
“enum”: [“01”, “02”, “03”, “04”, “”]
},
“authenticationValue”: {
“type”: “string”,
“maxLength”: 28
},
“challengeCancel”: {
“type”: “string”,
“enum”: [“01”, “02”, “03”, “04”, “05”, “06”, “07”, “08”, “”]
},
“dsTransID”: {
“type”: “string”,
“maxLength”: 36
},
“eci”: {
“type”: “string”,
“maxLength”: 2
},
“interactionCounter”: {
“type”: “string”,
“maxLength”: 2
},
“messageCategory”: {
“type”: “string”,
“enum”: [“01”, “02”]
},
“messageExtension”: {
“type”: “string”,
“maxLength”: 81920
},
“messageVersion”: {
“type”: “string”,
“minLength”: 5,
“maxLength”: 8
},
“sdkTransID”: {
“type”: “string”,
“maxLength”: 36
},
“transStatus”: {
“type”: “string”,
“enum”: [“Y”, “N”, “U”, “A”, “C”, “D”, “R”, “I”, “”]
},
“transStatusReason”: {
“type”: “string”,
“enum”: [“01”, “02”, “03”, “04”, “05”, “06”, “07”, “08”, “09”, “10”, “11”, “12”, “13”, “14”, “15”, “16”, “17”, “18”, “19”, “20”, “21”, “22”, “23”, “24”, “25”, “26”, “”]
}
},
“required”: [“threeDSServerTransID”, “acsTransID”, “acsRenderingType”, “authenticationType”, “authenticationValue”, “challengeCancel”, “dsTransID”, “eci”, “interactionCounter”, “messageCategory”, “messageExtension”, “messageVersion”, “sdkTransID”, “transStatus”, “transStatusReason”],
“additionalProperties”: false
}
Sample
{
“threeDSServerTransID”:”9e944d5d-56f3-461d-a393-80a666d346d1″,
“acsTransID”:”1e43b52f-3623-4e5d-8917-41c5c15b7218″,
“acsRenderingType”:{
“acsInterface”:”01″,
“acsUiTemplate”:”01″
},
“authenticationType”:”02″,
“authenticationValue”:”JAmi21makAifmwqo2120cjq1AAA=”,
“challengeCancel”:””,
“dsTransID”:”c626e8a0-f2ba-42b3-aa6d-620658421f3a”,
“eci”:”05″,
“interactionCounter”:”01″,
“messageCategory”:”01″,
“messageExtension”:””,
“messageVersion”:”2.1.0″,
“sdkTransID”:””,
“transStatus”:”Y”,
“transStatusReason”:””
}
