Skip to main content

ErrorObject

Represents a 3DS Error (Erro) message object.

acsTransIDstring<uuid>nullable

Universally unique transaction identifier assigned by the ACS to identify a single transaction. Categories: PA, NPA. Channels: APP, BRW, 3RI.

dsTransIDstring<uuid>nullable

Universally unique transaction identifier assigned by the DS to identify a single transaction. Categories: PA, NPA. Channels: APP, BRW, 3RI.

Possible values: <= 36 characters

errorCodestringrequired

Code indicating the type of problem identified in the message.

  • 101: Message Received Invalid
  • 102: Message Version Number Not Supported
  • 103: Sent Messages Limit Exceeded
  • 201: Required Data Element Missing
  • 202: Critical Message Extension Not Recognised
  • 203: Format of one or more Data Elements is Invalid according to the Specification
  • 204: Duplicate Data Element
  • 301: Transaction ID Not Recognised
  • 302: Data Decryption Failure
  • 303: Access Denied, Invalid Endpoint
  • 304: ISO Code Invalid
  • 305: Transaction data not valid
  • 306: Merchant Category Code (MCC) Not Valid for Payment System
  • 307: Serial Number not Valid
  • 402: Transaction Timed Out
  • 403: Transient System Failure
  • 404: Permanent System Failure
  • 405: System Connection Failure

Possible values: [101, 102, 103, 201, 202, 203, 204, 301, 302, 303, 304, 305, 306, 307, 402, 403, 404, 405]

errorComponentstringrequired

Code indicating the 3-D Secure component that identified the error.

  • C: 3DS SDK
  • S: 3DS Server
  • D: Directory Server
  • A: ACS

Possible values: [C, S, D, A]

errorDescriptionstringrequired

Text describing the problem identified in the message.

Possible values: <= 2048 characters

errorDetailstringrequired

Additional detail regarding the problem identified in the message.

Possible values: <= 2048 characters

errorMessageTypestringnullable

Identifies the Message Type that was identified as erroneous.

Possible values: [ARes, AReq, PRes, PReq, CRes, CReq, RReq, RRes, Erro]

messageTypestringrequired

Identifies the type of message that is passed. Categories: PA, NPA. Channels: APP, BRW, 3RI.

Possible values: [Erro]

messageVersionstringrequired

Protocol version identifier. This shall be the Protocol Version Number of the specification utilised by the system creating this message. Categories: PA, NPA. Channels: APP, BRW, 3RI.

Possible values: [2.2.0]

sdkTransIDstring<uuid>nullable

Universally unique transaction identifier assigned by the 3DS SDK to identify a single transaction. Categories: PA, NPA. Channels: APP. Conditions: Required if deviceChannel is "01". Required if messageType is one of [AReq, ARes, CReq, CRes, RReq, RRes].

threeDSServerTransIDstring<uuid>required

Universally unique transaction identifier assigned by the 3DS Server to identify a single transaction. Categories: PA, NPA. Channels: APP, BRW, 3RI.

ErrorObject
{
  "acsTransID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "dsTransID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "errorCode": "101",
  "errorComponent": "C",
  "errorDescription": "string",
  "errorDetail": "string",
  "errorMessageType": "ARes",
  "messageType": "Erro",
  "messageVersion": "2.2.0",
  "sdkTransID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "threeDSServerTransID": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}