Table of Contents
Overview
When processing a ChipDNA Direct request, our platform will return a response informing the integrator whether the ChipDNA Direct 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
| Result Code | Message | Description |
|---|---|---|
| 00 | Approved | The transaction has been approved |
| 01 | Declined | The transaction has been declined |
| 02 | Voice Referral Required | The transaction should be processed as a voice referral |
| 99 | Test OK | Test result OK. NMI is processing transactions |
Error Codes
| Error Code | Message | Description |
|---|---|---|
| 2200 | Transaction Not Found | The specified transaction in the request was not found. |
| 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 NMI platform is temporarily unavailable |
| 8001 | Invalid XML Request | The request XML is invalid |
| 8002 | Invalid Message Type | The specified request type is invalid |
| 8003 | Missing Element | The request does not contain all of the expected XML elements such as the GwTransactionId |
| 8004 | Invalid Data | An invalid piece of information was sent in the request or data was missing |
| 8005 | XML Decryption Error | It is not possible to decrypt the XML |