Error Codes
Table of contents
Overview
As “The Flow” page showed, the AuthenticationResult the uSDK passed as an argument to the AuthenticateCallback may contain information about an error occured during the flow. The error information actually consists of three data elements:
errorCode- a string representation of a number error code this page details out furthererrorDescription- a human readable message that tells what the error is abouterrorDetails- some low-level details such as an excerpt from a stacktrace etc. This is rather for a developer to help troubleshooting an issue.
Error Codes
Given in most cases the client application will use the errorCode data element to make decisions about the flow this page serves as a reference of the error codes.
| Error Code | cAPI Server/Client failed… |
|---|---|
| 1001 | to find a transaction by its identifier |
| 1002 | to lookup ephemeral transaction data |
| 1003 | to lookup transaction exchange data it should have received from Merchant Backend |
| 1004 | to decrypt a 3DS challenge |
| 1005 | to encrypt deviceInfo for given DS |
| 1006 | to lookup Directory Server by supportedVersions response received from 3DS Server |
| 1100 | to exchange transaction data with Merchant Backend |
| 1101 | to deliver transaction result to Merchant Backend |
| 1110 | to get supported 3DS versions from 3DS Server for given acctNumber |
| 1111 | to deliver the initialial request to the 3DS Server |
| 1112 | to get transaction result from the 3DS Server |
| 1120 | to conduct challenge exchange with ACS |
| 1121 | to validate acsSignedContent |
The uSDK itself may produce the following error(s)
| Error Code | |
|---|---|
| 998 | a catchall error raised by the Download SDK |
| 999 | a catchall error raised by SplitSDK Android/iOS Client |
If there’s an error occured during the 3DS exchange then one of the following error codes can be returned:
| Error Code | Meaning |
|---|---|
| 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 |