Error Codes and suggested resolution

This table lists the error codes that you may experience when working with 3DS APIs. For unresolvable errors, contact Elavon support at#SEDevPortalSupport@elavon.com

Error codeError TextError DescriptionSuggested resolution
101Message InvalidReasons could be one of the following:

  • Message not recognized

  • Invalid message type

  • Invalid message for the receiving component

  • Invalid formatted message

Validate the request for the error highlighted in the error detail. If you made the required updates, but still get this error, contact Elavon support.
102Message version is not supportedMessage version received is not valid for the receiving component.Validate the messageVersion field in the request. Valid values are 2.1.0 or 2.2.0.
103Sent Messages Limit ExceededExceeded maximum number of messages.Send the request after some time. If you still get this error, contact Elavon support.
201Missing required data elementA required 3D Secure Data Message element is missing. For example, if acctNumber, a required field, is missing in the /3ds2/authenticate requestValidate the request and include the required data elements that are listed in the error detail. See the API reference table for an authenticate request parameters description.
If you made the required updates, but still get this error, contact Elavon support.
202Critical Message Extension Not RecognizedID of critical Message Extension(s) that was not recognized; if more than one extension is detected, this is a comma-delimited list of message identifiers that were not recognized.The EMVCo 3DS 2.1/2.2 specifications do not define any critical extension. This error code might be returned if the criticalityIndicator field in the /3ds2/authenticate request is set to true. If you get this error, contact Elavon support.
203Format of one or more Data Elements is Invalid according to the EMV SpecificationCould be returned for one of the following reasons:

  • Data element not in the required format or value is invalid

  • Message Version Number does not match the value set by the 3DS Server in the authentication request message.

  • Data element is present in a message where the conditional inclusion does not apply.
  • acsUiTemplate = 05 is supported only for acsInterface = 02.
Validate the request and correct the value format for data elements listed in the error detail. See the API reference table for an authenticate request parameters description. If you made the required updates, but still get this error, contact Elavon support.
204Duplicate Data ElementValid data element is present more than once in the message.Validate the request and delete the duplicate instance of the data elements listed in the error detail. If you made the required updates, but still get this error, contact Elavon support.
301Unknown transaction IDTransaction ID received is not valid for the receiving component. Invalid could mean that the Transaction ID is not recognised, or is recognised as a duplicate.Validate that the threeDSServerTransID field value in the request matches the threeDSServerTransID field value you received in the corresponding authenticate response.
302Data Decryption FailureData could not be decrypted by the receiving system due to technical or other reasons.Verify that the field mentioned in the error details is encrypted according to 3DS specifications. In mobile SDK, the sdkEncData field is encrypted by SDK for the DS to decrypt. In case of a challenge, the mobile SDK encrypts the cReq and sends it as a JWE encrypted string to the ACS.
303Access Denied, Invalid EndpointAccess denied, invalid endpoint.To resolve this error, verify the following conditions and send the request again.

  • The endpoint in the API request is valid.

  • The user credentials are correct.

  • The URI is valid.

  • The method used is correct. For example, if you used GET instead of POST.

  • The content type is ‘application/json’

  • The authentication token has not expired for the session. Get a new authentication token.

304ISO Code InvalidISO code not valid for either country or currency.Validate the ISO code. If the ISO code is valid, ensure that you are sending all required and conditional data elements in the request. See the API reference table for an authenticate request parameters description. If you still get this error, contact Elavon support.
305Transaction data not validIf in response to an authentication request message:

  • Cardholder Account Number is not in a range belonging to the Issuer

If in response to a challenge request, and a challenge request message was incorrectly sent, the reason could also be one of the following:

  • challenge request message was received by the wrong ACS

  • challenge request message was not sent, based on the values in the authentication response message

  • challenge request message with this ACS Transaction ID has already been received and processed

You might get this error when the card is not supported or there is an error processing the challenge. Suggest the user use a different card for the transaction.
306Merchant Category Code (MCC) Not Valid for Payment SystemMerchant Category Code (MCC) not valid for Payment System. For example, invalid MCC received in the authenticate request.Check the MCC is correct. If you still get this error, then it could be an account configuration issue. Contact Elavon support.
402Transaction Timed OutTransaction timed-outThis error is generally returned if there is a system issue. Try again later and if the issue persists, contact Elavon support.
403Transient System FailureTransient system failure. For example, a slow processing backend system.This error is generally returned if there is a system issue. Try again later and if the issue persists, contact Elavon support.
404Permanent System FailurePermanent system failure. For example, a critical database is inaccessible.This error is generally returned if there is a system issue. Try again later and if the issue persists, contact Elavon support.
405System Connection FailureSystem connection failure. For example, the sending component is unable to establish a connection with the receiving component.This error is generally returned if there is a system issue. Try again later and if the issue persists, contact Elavon support.

Related topics