Error categories | Description |
---|---|
E (Connectivity Error) | occurs, when there is no connection with a server due to network connectivity issues. For example, the connection might time out due to a failure in the internet connection. |
L (Login/Security Error) | occurs when a login attempt is unsuccessful or a user misses one or more privileges to be able to use API; |
F (Formatting Error) | occurs when data provided by a submitter does not adhere to the formatting requirements. For example, a submitted value for phone field contains letters or a submitted value for amount field is negative; |
V (Data Verification Error) | occurs when data provided by a submitter is well-formatted, but one or more values are not valid from the business context. For example, referenced merchant account does not exist or a specified transaction industry type has not been found within a list of the allowed values; |
O (Configuration Error) | occurs when data provided by a submitter is well-formatted and valid, but specific settings required for a transaction to be processed are not configured correctly. For example, there are no pricing templates configured within specified portfolio while a merchant that is being created cannot be onboarded without these settings; |
U (Unsupported Action Error) | occurs when data has been validated successfully and all required settings are configured, but specified operation/feature is not supported either by the gateway or a processor. For example, operation is not supported by an underlying processor or cashback is not supported for sale-info or credit-info operations; |
S (System Error) | an internal system error occurred. Gateway support should be reached out; |
Q (Security Error) | occurs when there is a possibility of a security breach or missed encoding; |
W (Warning) | no error occurs. However, transaction processing did not go smoothly, and a warning has been received. To review the warning related to the transaction, see the system error log or a system audit notification is received by the gateway. |
Message | Description |
---|---|
User message | a message describing what caused the error, for example, zipCode is not well-formatted. |
Developer message | a message containing a list of dynamic parameters included in the user message. Using these parameters, you can override user messages with your own custom error messages. See Processing Management Guide for more information. |
Hint | a number, which refers to the additional information about an error, for example, Hint:1. If a hint is returned as a part of the failure message, you should refer to the description of the corresponding error in the section below. |
Code | User Message | Developer Message | Description |
---|---|---|---|
S20 | OriginName error. Contact support. |
object: OriginName |
An error that cannot be resolved by the user has occurred within the system. Please contact support for further investigation.
For example, there is an issue with the database and it is not available at the moment. Hint 1: There is an application deployment integrity issue. Possibly you are missing some of the required libraries or some of the JAR files are damaged or not properly built. Contact gateway support or verify whether the application was deployed correctly. Hint 2: There is a possible settlement issue with the processor that you currently use. Contact gateway support for assistance. Hint 3: The number of available connections allocated by the processor for concurrent processing is not sufficient to handle gateway’s incoming volume; because of this some transactions are timing out. To resolve the issue, either increase a transaction timeout in the gateway or reach out to the processor and request to allocate more connections on its side. Hint 4: The number of cluster nodes does not match the number of available connections allocated by the processor for concurrent processing. To resolve the issue, adjust either real-time nodes configuration or processor's profile settings. |
S21 | Connectivity issue with ServiceName. Contact support. |
object: ServiceName |
An unexpected error occurred on a processor's side. You can contact support to initiate further investigation.
For example, the processor's servers are down at the moment. Hint 1: 3D verification has failed due to an error on a bank's side. |
S23 | We are experiencing temporary connectivity issues with ConnectivityErrorName | ServiceName. Contact support. |
object: ServiceName, ConnectivityErrorName |
There is an issue with the connection between the gateway and either a processor or a particular gateway module. Please contact support for further investigation.
For example, terminal cloud is unavailable at the moment due to an internal error. |
S24 | Payment page configuration issue. Contact support. |
An error has occurred due to the incorrect payment page configuration. Please contact support for further investigation.
For example, responseMessageDisplayPolicy setting has been set as (-D-), i.e. only developer messages have been selected to be shown on the payment pages, and one or more errors were not overridden by the getUserMessage function. See Processing Management guide for more information. Note: The error code is available starting with the 7.1 release. |
|
S24 | Data you are trying to use is corrupted. Contact support. |
Particular data cannot be read and/or processed by the system because of an invalid format. Please contact support for further investigation.
Note: The error code is now deprecated. Starting with the 7.1 release, the error is replaced with S34. |
|
S25 | ProcessName process failed. Contact support. |
object: ProcessName |
An internal error occurred during the indicated process. Please contact support for further investigation.
For example, encryption process cannot be completed due to a missing encryption key. |
S26 | Operation RequestType declined by the processor. |
An operation has been declined by a processor. Applied to void and capture operations only. |
|
S27 | No Internet connection detected. |
Internet connection is disabled on a device. Make sure you have enabled Internet on the mobile device. |
|
S28 | Unable to submit FormatName to ProfileType. Daily limit of FormatNames is reached. |
object: FormatName, object: ProfileType |
A file/transaction cannot be processed by a processor due to the daily limit of files/transactions submission being exceeded. Please try again tomorrow. |
S29 | No data is available for the specified criteria. |
An operation cannot be performed for the parameters indicated in the request. Try to submit different criteria.
For example, a report cannot be generated for the criteria specified in the request. |
|
S30 | Concurrent data modification issue. Reload data and reapply changes. |
Data modification is not possible due to mismatch of the version of parameters. Used in the TMS API.
Hint 1: Concurrent data modification issue occurs due to the discrepancy between data on the terminal and on the server. You should reset the terminal to factory settings, reset the terminal settings on the server and go through the process of terminal initialization again. |
|
S31 | Unable to create "ObjectName": Code - "code". Message - "message". |
reference: ObjectName, "code", "message". |
The referenced entity does not exist within the system, because it is declined by the processor. The referenced code and message are code and message of a decline.
For example, a billing transaction does not create within the system because of D03: Insufficient Funds. |
S32 | Referenced ReferenceName is not found within the system. Contact support. |
reference: ReferenceName |
The referenced entity does not exist within the system. Please contact support for further investigation.
For example, a batch response file is sent from a processor to the gateway, but the corresponding request file cannot be found within the system. |
S33 | Data cannot be extracted from the archive. Verify integrity of the file. |
The submitted archive cannot be read or unzipped. Make sure you are submitting a file in proper format. |
|
S34 | Invalid FormatName format detected or FormatName is corrupt. Contact support.
|
object: FormatName |
A particular file or data cannot be read and/or processed by the system because of an invalid format. Please contact support for further investigation.
For example, the system downloads an aggregated file from a processor but due to the invalid format, the file cannot be divided in several files and processed correctly. Hint 1: Your SQL request is invalid and cannot be processed. Verify that a query you are trying to execute is among a list of queries that are allowed to be used within the DQM module. See the following document for more information about the queries that are prohibited to run. Hint 2: An archive with terminal tasks, which a user attempts to upload to the repository, has an invalid structure: the name of the second-level directory within the archive does not correspond to the value of a terminal task enumeration. Contact gateway support for assistance or try to upload a different archive. Hint 3: Buffer overflow error: data sent from the server/POS to a terminal is too large. Hint 4: The file you are attempting to submit is too large. Hint 5: The format is valid, but uses some features that are either not supported or disallowed. For example, the xml format is valid by itself, but it uses a doctype declaration, which is prohibited because of PCI-compliance in our system. |
S35 | Data encoding issue detected. Contact support. |
A particular file or data cannot be processed due to an internal encoding error. Please contact support for further investigation.
For example, an aggregated file downloaded from a processor's FTP cannot be parsed correctly. |
|
S36 | MethodName is not supported. |
object: MethodName |
The method you are attempting to use is not supported for the submitted API request. Verify what methods are available for the request you are attempting to submit and make sure that the method you are using is allowed.
For example, you are attempting to use GET method, which is not supported for processing real-time API requests. |
S38 | Maximum number of ReferenceNames is reached at the LevelName level. |
reference: ReferenceName, level: LevelName |
The indicated entity cannot be created due to the limit of the entities of this kind being exceeded. For example, you are attempting to create an account #1000 under a merchant that already has 999 accounts, which is a maximum number of the accounts that the merchant can have.
Hint 1: A maximum number of pre-allocated Discover MIDs is reached. Contact gateway support for assistance. |
S39 | Unable to read or process the card. |
Unable to process the card and exact reason for this cannot be defined.
For example, system cannot receive card number as unknown issue occurred while attempting to read card data. |
|
S40 | Data integrity violation. Contact support. |
In the process of communication between 2 endpoints, there were problems with the integrity of the data related to security (due to the signature miss match or due to problems with the certificate).
Hint 1: The transaction with this digital signature has already been processed. |
|
S42 | Unable to complete action. Contact support. |
The submitted action cannot be processed due to the specified system settings. Please contact support. |
|
S43 | Necessary permission is missing. |
The application needs access to the device's resources to operate fully. Errors typically arise when users either fail to grant or deny the permissions essential for the app's proper functionality. This restriction of permissions hampers the app's ability to work correctly. |
|
S99 | Internal error. |
An internal error occurred. Please contact support for further investigation. |