Table of Contents
Overview
When processing a Direct Connect request, our platform will return a response informing the integrator whether the Direct Connect request was successful or not. This is determined using the result codes and error codes mentioned below.
If an error code is returned it means the request was unsuccessful as an issue was identified by our platform. If an error code is returned, the result code will always be 01 (declined). Requests will not be sent to the acquirer/processor for approval. Please review the error code descriptions below to help rectify the issue.
If a result code of 01 (declined) is returned with no error code, the request was unsuccessful. For 'Authorization' / 'PreAuth' requests, this will normally be a decline from the bank.
If either a result code of 01 or an error is returned, the request was unsuccessful. For an 'Authorization' request, goods should not be provided to the customer. For a 'Confirm' / 'Void' request, this should be retried after the error has been rectified within your integration. Please note, if the 'Confirm' request fails, the transaction will not be sent for settlement and you will not receive the funds until the 'Confirm' is successful.
Result Codes
| Error Code | Message | Description |
|---|---|---|
| 1001 | Expired Card | The specified card in the request has expired |
| 1002 | Pre Valid Card | The specified card in the request is not yet effective |
| 1003 | Card Scheme Not Supported | The specified card scheme in the request is not supported |
| 1004 | Card Usage Exceeded | The specified card usage in the request has been exceeded |
| 1005 | Card Banned | The specified card in the request has been banned |
| 1006 | Not Allowed | The specified transaction in the request is not allowed |
| 1200 | PAN Missing | The request does not contain a PAN |
| 1201 | PAN Invalid | The specified PAN in the request is invalid |
| 1202 | PAN Too Long | The specified PAN in the request is too long |
| 1203 | PAN Too Short | The specified PAN in the request is too short |
| 1204 | PAN Fails Luhn Check | The specified PAN in the request fails the Luhn check |
| 1210 | Expiry Date Missing | The request does not contain an expiry date |
| 1211 | Expiry Date Invalid | The specified expiry date in the request is invalid |
| 1220 | Start Date Missing | The request does not contain a start date. |
| 1221 | Start Date Invalid | The specified start date in the request is invalid |
| 1230 | Issue No Missing | The request does not contain an issue number |
| 1231 | Issue No Invalid | The specified issue number in the request is invalid |
| 1235 | Card Reference Invalid | The specified card reference in the request is not valid |
| 1236 | Card Hash Invalid | The specified card hash in the request is not valid |
| 1240 | Amount Missing | The request does not contain an amount |
| 1241 | Amount Invalid | The specified amount in the request is invalid |
| 1242 | Amount Too Small | The specified amount in the request is too small |
| 1243 | Amount Too Large | The specified amount in the request is too large |
| 1250 | Message Type Missing | The request does not contain a message type |
| 1251 | Message Type Invalid | The specified message type in the request is invalid |
| 2002 | Terminal ID Unknown | The specified terminal ID is unknown, missing, invalid or disabled |
| 2005 | Terminal Usage Exceeded | The specified terminal ID usage in the request has been exceeded |
| 2021 | Transaction Key Missing | The specified transaction key in the request is missing |
| 2100 | CardEase Reference Missing | The request does not contain a CardEase Reference |
| 2101 | CardEase Reference Invalid | The specified CardEase Reference in the request is invalid |
| 2110 | Card Details Unavailable | The card details referenced by the Card Reference and Card Hash are unavailable |
| 2111 | Card Details Not Found | The card details referenced by the Card Reference and Card Hash could not be found |
| 2200 | Transaction Not Found | The specified transaction in the request was not found |
| 2201 | Transaction Already Settled | The specified transaction in the request has already been settled |
| 2202 | Transaction Already Voided | The specified transaction in the request has already been voided |
| 2203 | Transaction Already Refunded | The transaction has already been refunded in full |
| 2204 | Transaction Originally Declined | The specified transaction in the request was originally declined |
| 3001 | API Key Missing | The API key wasn’t sent in the request |
| 3002 | Invalid API Key | The API key wasn’t valid due to invalid characters or not being 32 characters in length |
| 3010 | Rejected Transaction | The NMI platform declined the transaction |
| 3013 | General Error | The NMI platform declined the transaction |
| 3025 | Merchant Configuration Error | There is a configuration issue with the merchant |
| 3026 | Missing Field | A mandatory field is missing such as the currency code |
| 3027 | Invalid Field | A submitted field is invalid |
| 3028 | Invalid HTTP Method | The HTTP method used is invalid |
| 3029 | Access Denied | The current user doesn’t have the correct access permissions |
| 3030 | Device Configuration Error | The device isn’t configured correctly |
| 3031 | Unexpected Value | An unexpected field was submitted in the request |
| 3032 | Data Type Invalid | An incorrect data type was used |
| 3033 | Parse Error | An error occurred parsing the data |
| 3034 | Server Error | An error occurred with the server |
| 3035 | General Error | A general error occurred |
| 3333 | Unknown Error | An unknown error occurred |
| 7000 | Temporarily Unavailable | The CardEase platform is temporarily unavailable |
| 8001 | Invalid XML Request | The request XML is invalid |
| 8002 | Invalid Message Type | The specified request type is invalid |
| 8003 | XML Element Missing | The request does not contain all of the expected XML elements |
| 8004 | Invalid Data | An invalid piece of information was sent in the request |
| 8005 | XML Decryption Error | It is not possible to decrypt the XML |