Response Codes
Quick Find
Go straight to the section you need.
1.0 Gateway Integration →
2.0 New Transactions →
3.0 Management Requests →
4.0 AVS/CV2 Checking →
5.0 3-D Secure Authentication →
11 Receipts and Notifications →
17 Advanced Data →
17.7 Device Information Fields
19 Gateway Wallet →
26 Digital Wallet Transactions →
Appendix
A-1 Response Codes
A-1.1 Authorisation Response Codes
A-2 AVS / CV2 Check Response Codes
A-3 Secure Authentication Data
A-4 3-D Secure Enrolment/Authentication Only
A-9 Duplicate Transaction Checking
A-10 Capture Delay
A-13 Sample Signature Calculation
A-14 Transaction Life cycle
A-14.1 Authorise, Capture and Settlement
A-15.2 Mail Order/Telephone Order (MOTO)
A-15.3 Continuous Authority (CA)
A-16 Payment Tokenisation
A-16.1 PREAUTH, SALE, REFUND, VERIFY requests
A-16.3 CANCEL or CAPTURE requests
A-16.5 SALE or REFUND Referred Authorisation requests
A-18 PSD2 SCA Compliance
A-18.1 Obtaining Strong Customer Authentication
A-18.3 Exemptions to Strong Customer Authentication
A-19 Hosted Payment Page Options
A-20 Integration Libraries
A-20.1 Gateway Integration Library
A-20.2 Hosted Payment Page Library
A-20.3 Hosted Payment Fields Library
A-21 Example HTTP Requests
A-22 Example Integration Code
A-23 Example Library Code
A-23.1 Gateway Integration Library
A1 Response Codes
A-1.1 Authorisation Response Codes
The Gateway uses a set of standard response codes to indicate the status of an authorisation request to the Acquirer. These response codes are based on the 2-character ISO 8583 response codes.
The full set of ISO 8583 codes used are given in the table below, however not all are applicable to transactions currently supported by the Gateway and therefore not used and documented for reference purposes only.
Some ISO-8583 codes are not numeric and therefore to ensure all Gateway response codes are numeric these codes are mapped to an equivalent numeric code greater than 99. This equivalent numeric code is shown in the table below along with the original 2 letter code in brackets.
Not all ISO-8583 codes are applicable to the types of transactions currently available via the Gateway and therefore unapplicable codes, although documented, may not currently be returned.
If the authorising Acquirer does not return a suitable ISO 8583 code, then the Gateway will attempt to map the Acquirers response to a suitable code.
The original Acquirer authorisation response code and response message will always be returned in the acquirerResponseCode and acquirerResponseMessage fields as detailed in section 18.
The original Acquirer authorisation response code may not be numeric and information on these codes will need to be requested from the Acquirer.
Acquirer Authorisation Response codes: 0 – 9999
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
A-1.2 Gateway Response Codes
The Gateway uses a set of enhanced response codes to indicate if there is an issue with the transaction which prevented any authorisation response being received from the Acquirer. These response codes start at 65536.
The responses are grouped into categories and the codes in the ‘missing’ and ‘invalid’ field categories are designed so that that invalid field code is exactly 256 greater than the corresponding missing field code. For example, the code of a missing action field is 66055 and the corresponding code for an invalid action field is 66311 (66055 + 256).
General Error Codes: 65536 – 65791
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
3-D Secure Error Codes: 65792 – 65823
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Remoted Checkout Processing Error Codes: 65824 – 65885
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Risk Check Processing Error Codes: 65856 – 65887
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Missing Request Field Error Codes: 66048 – 66303 and 66560 – 66815
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description
Code
Description