Shift4 has created error codes to identify error conditions as they occur when processing a transaction. An error condition is any condition where a card was not successfully processed with an approval, referral, or decline response. When appropriate, the interface notifies the user when an error has occurred by displaying an error code, a short error message, and a long error message.
AVS and CSC failures are not considered error codes; instead, they are considered non-authorized responses from the issuer.
During testing, please contact your assigned API Analyst for assistance if you encounter a critical error or if any error persists after you attempt a solution described below.
The initial implementation of the error object consists of a primarycode and secondaryCode field, that when combined specify a particular error condition. In order to simplify the error handling process Shift4 has introduced a single error.code field that will be used going forward for errors. All new errors will be added to the error.code field and existing error codes will be mapped to an error.code value.
The error.code field will be initially implemented for transactions processed via our hosted REST servers for European merchants.
| error.code | error.shortText | error.longText | error.severity |
|---|---|---|---|
| 40000 | Nonspecific | Nonspecific Client Error | Error |
| 40001 | Timed Out | Transaction timed out | Error |
| 40100 | Invalid Param | Client request invalid | Info |
| 40101 | Invalid Param | Client request invalid field data | Info |
| 40102 | Invalid Param | Client request missing field | Info |
| 40103 | Invalid Param | Client request invalid format | Info |
| 40104 | Invalid Param | Client request invalid invoice | Info |
| 40105 | Invalid Param | Token not found | Info |
| 40106 | Invalid Param | Token expired | Info |
| 40107 | Invalid Param | Invalid amount for transaction | Info |
| 40300 | Not Allowed | Client authorization error | Info |
| 40400 | Encryption Error | Encryption Error | Error |
| 40401 | Encryption Error | Decryption Error | Error |
| 40402 | Tran Failed | Split tender required | Error |
| 40403 | Tran Failed | No card info | Error |
| 40404 | Tran Failed | No PIN entered | Error |
| 40405 | Tran Failed | No MSR data | Error |
| 40500 | Pinpad Error | Pinpad Error | Error |
| 40600 | Misconfigured | Misconfigured. Please contact support. | Alert |
| 50000 | Nonspecific | Nonspecific Server Error | Error |
| 50001 | Network Error | Connection Error | Error |
| 50002 | Timed Out | Connection Timeout | Error |
| 50100 | Tran Failed | Transaction failed, invalid status | Error |
| 50101 | Tran Failed | Transaction cancelled | Error |
| 50102 | Tran Failed | Transaction already in progress | Error |
| 52011 | Network Error | Processor Down | Alert |
| 59839 | System Error | Database Error | Alert |
| 59999 | System Error | Internal Server Error | Error |
| 60000 | Nonspecific | Nonspecific Host Error | Error |
| 64000 | Nonspecific | Host Client Error | Error |
| 64001 | Nonspecific | Nonspecific Host Client Error | Error |
| 64002 | Timed Out | Timeout waiting for response | Error |
| 64500 | Duplicate | Duplicate authorization | Error |
| 65000 | Nonspecific | Nonspecific Host Server Error | Error |
| 65100 | Network Error | Unable to connect to host | Alert |
| 66000 | Nonspecific | Nonspecific Host 3rd Party Errors | Error |
| 66600 | Nonspecific | Nonspecific TSYS error | Error |
| 66652 | Network Error | Unable to connect to issuer | Error |
| 67069 | Invalid Param | Transaction has been declined. Invalid 3ds_version parameter. | Info |
| 67068 | Timed Out | Authentication process timed out. Please try again. | Error |
| 67066 | Invalid Param | Invalid combination of 3ds_initiate and exemption_action values | Info |
| 67065 | Not Allowed | Merchant is not allowed for this exemption | Info |
| 67064 | Not Allowed | Exemption is not allowed for this transaction amount | Info |
| 67063 | Not Enrolled | Merchant is not enrolled to 3D-secure service. | Info |
| 67050 | System Error | An error occurred during the 3D secure process | Info |
| 67039 | Not Enrolled | You need to be registered with the 3D Adviser service to complete the request | Info |
| 67037 | Missing Field | Transaction has been denied. Malformed or missing parameter. | Info |
| 67036 | Invalid Param | The selected processor does not support some of the parameters. | Info |
| 67035 | Service Unavail | Merchant is not registered. | Info |
| 67033 | Service Unavail | You need to be registered with the routing service to complete the routing request. | Info |
| 67032 | Service Unavail | You are not registered with the selected Processor. | Info |
| 67030 | Tran Failed | Transaction Failed due to error in 3D secure process. | Info |
| 67020 | System Error | Processor authentication error. Please contact Credorax support. | Info |
| 67017 | Service Unavail | Fraud-protection service is unavailable | Error |
| 67016 | Not Allowed | Rejected. Overriding the fraud threshold is not allowed | Info |
| 67015 | Not Allowed | Rejected. Bypassing the fraud service is not allowed. | Info |
| 67013 | Not Enrolled | The requested gateway mid is not enrolled in the 3D Secure Adviser service. | Info |
| 67012 | Tran Failed | Transaction has been declined due to security restrictions. | Info |
| 67011 | Invalid Param | Rejected. Format Error | Error |
| 67010 | System Error | System error. Please contact support. | Error |
| 67009 | Invalid Param | Parameter(s) malformed | Info |
| 67008 | Invalid Param | The Package Signature is malformed. | Info |
| 67007 | Network Error | Incorrect Gateway Response. Connection is broken. | Error |
| 67101 | Not Allowed | Transaction not allowed | Info |
| 67102 | Tran Failed | The transaction has been denied by the Gateway due to its high fraud risk. | Info |
| 67103 | Tran Failed | The transaction has been denied by the Gateway due to its high AVS risk. | Info |
| 67104 | Timed Out | The transaction has been denied by the Gateway due to an interchange timeout. | Error |
| 67107 | Tran Failed | The transaction was declined by the gateway and will not be processed due to retry optimization policy. | Info |
| 67109 | Tran Failed | The transaction has been denied by the Gateway due to a LUHN check failure | Info |
| 67111 | Duplicate | The queried transaction is currently being processed. Please try again. | Info |
| 67113 | Service Unavail | Rejected. The fraud-protection service is unavailable. | Info |
| 67115 | Tran Failed | Rejected. Risk score is above limit. | Info |
| 67117 | System Error | Transaction could not be checked against merchant rules. | Info |
| 67119 | Network Error | Response timeout. | Error |
| 67121 | Invalid Response | Rules check has returned an invalid value. | Info |
| 67123 | Trans Failed | Transaction violates merchant rules. | Info |
| 69999 | System Error | Host System Error | Error |
| primaryCode | secondaryCode | error.code Mapping | shortText | longText | Cause |
|---|---|---|---|---|---|
| 1001 | 0 | 50001 | [Processing Service] UNAVAILABLE | No connection to processor | Connection to processor not available. |
| 2011 | 0 | 52011 | [Varies, depending on failure] | Communication failure to processor | Communication failure with processor. |
| 4003 | 0 | 64002 | [Text varies] | Timeout waiting for response | No response from remote system. |
| 9012 | 0 | 50002 | Com Timeout | Timeout waiting for response from modem | Modem/serial error. |
| 9018 | 0 | 50002 | Com Enq Timeout | Timeout waiting for ENQ | Modem/serial error. |
| 9020 | 0 | 50002 | Com Ack Nak Timeout | Timeout waiting for ACK or NAK | Modem/serial error. |
| 9023 | 0 | 50002 | Comm Char Timeout | Timeout Timeout waiting for a character | Modem/serial error. |
| 9033 | 0 | 40001 | TRAN TIMEOUT | Shift4 Client Socket Timeout | Connection problem between vendor software and the UTG. |
| 9036 | 0 | 40101 | APIInvData | Invalid data in API request | Transaction request contains invalid data. |
| 9070 | 0 | 40500 | BASEKEY FAILURE | The P2PE key injected in the device is not valid. | |
| 9076 | 0 | 40400 | INCORRECT FORMAT | Original encryption format not supported | Device is set for original encryption mode. |
| 9076 | 1 | 40400 | INCORRECT FORMAT | TDES not supported | Device is set up for Triple DES. |
| 9076 | 2 | 40400 | INCORRECT FORMAT | The encrypted block is corrupted or in an unknown format | Unable to decrypt data. |
| 9076 | 3 | 40400 | DECRYPTION FAILED | The encrypted block is corrupt | Unable to decrypt data. |
| 9076 | 6 | 40400 | NOT P2PE DATA | The P2PE device returned unencrypted Card Brand data. Call Shift4 Support immediately. | |
| 9083 | 1 | PLEASE RETRY | Problem processing form request | ||
| 91XX‡ | 0 | [Response varies, depending upon error] | Host Error | Processor host error. | |
| 9179 | 0 | 40000 | USEMCE ERROR | Can’t specify track information when using USEMCE | POS Vendor sent track information along with the USEMCE option. |
| 9179 | 1 | 40000 | USEMCE ERROR | Can’t specify card information when using USEMCE | POS Vendor sent card informationalong with the USEMCE option. |
| 9179 | 2 | 40000 | USEMCE ERROR | Can’t specify card.token.value when using USEMCE | POS Vendor sent a card.token.value along with the USEMCE option. |
| 9180 | 0 | 40000 | PAN MISMATCH | Personal Account Number mismatch between tags 57 and 5A | The cardholder’s card has a different card number in the track 2 equivalent data (tag 57) and the Application PAN (tag 5A) on the Chip. Request a different form of payment. |
| 9270 | 0 | 40405 | NoMSRdata | No MSR data | |
| 9271 | 0 | 40500 | NoCouponData | No Coupon Data | |
| 9401‡ | 0 | 40300 | DB NO RETURN | Credit (Returns) cannot be processed for Debit cards | Some processors do not support debit refunds. |
| 9402 | 0 | 40300 | NEED TRACK2 | Debit Transactions require a track2 swipe. | Debit transactions require Track 2 data. EBT transactions require track 2 data or must be manually keyed. |
| 9402 | 0 | 40300 | TRACK 1 N/A | EBT/Food Transactions require a track2 swipe or manual keyed. | Debit transactions require Track 2 data. EBT transactions require track 2 data or must be manually keyed. |
| 9402 | 1 | 40300 | NOT A DEBIT CARD | Debit transaction cannot be processed with this card. | Debit not allowed for this account. |
| 9501 | 3 | 40500 | INVALID INPUT | INVALID INPUT FROM CUSTOMER | Customer pressed an unrecognized button on the PIN pad. |
| 9501 | 3 | 40500 | NO INPUT FROM CUST | NO INPUT FROM CUSTOMER | The transaction failed due to no input from the consumer in the specified time. |
| 9501 | 3 | 40500 | No DUKPT Key | Device not seeded | The pin pad was not injected correctly. |
| 9501 | 3 | 40500 | TRAN Cancelled | No pin entered | Transaction cancelled by customer. |
| 9501 | 20 | 40500 | UNABLE TO READ CARD | UNABLE TO READ CARD DATA | Card reader is bad or dirty. |
| 9551 | 2 | 50101 | CANCELLED | Transaction cancelled by user | The transaction was cancelled by the user. |
| 9551 | 2 | 50101 | NO PIN | NO PIN was entered by the cardholder | Customer did not enter the PIN. |
| 9551 | 88 | 40100 | NO FALLBACK | Fallback is not supported for this transaction | Fallback is not supported for this transaction |
| 9553 | 1 | 40000 | BAD IMAGE | Photo type not supported | A format other than PNG was specified. |
| 9601 | 1 | 40404 | NO PIN | No PIN entered by customer | Customer did not enter the PIN. |
| 9803 | 0 | 40100 | INVALID CK | Checks CK for Merchant ID not found | Check verification not configured for merchant. |
| 9803 | 0 | 40100 | INVALID DCC | Dynamic Currency Conversion for Merchant Id not found | DCC not configured for merchant. |
| 9803 | 0 | 40100 | INVALID MID | Invalid Shift4 merchant ID or card type not configured for merchant | The MID is not recognized by Shift4. |
| 9803 | 0 | 40100 | INVALID MID | Merchant ID is zero | POS software is sending '0' as MID. Invalid merchant ID. |
| 9815 | 0 | 40104 | NO INV | Invoice not found | Invoice number not found in database. |
| 9819 | 0 | 40403 | NO CARD INFO | ENGINE[Varies] | |
| 9820 | 0 | 40000 | LUHN FAIL | Card doesn't pass Luhn check | Account number did not pass Luhn mod 10 check. Card is possibly invalid. |
| 9824 | 0 | 40104 | INVALID INVOICE | Invoice is invalid - not numeric | Invoice number contains non-numeric data. |
| 9836 | 0 | 40402 | CARD MISMATCH | Can't Change Cards-Split tender is required | One card is being used for authorization and another for settlement on the same transaction. |
| 9837 | 0 | 40101 | BAD EXPIRATION | Invalid Exp Date | Expiration date not valid. |
| 9837 | 0 | 40101 | EXPIRED CARD | This card has expired | Card has expired. |
| 9838 | 0 | 59839 | AMT EXCEEDED | Amount exceeded $999,999.99 | Amount exceeded $999,999.99. Cannot process transactions greater than that. |
| 9838 | 1 | 59839 | AMT EXCEEDED | Amount Exceeds Offline Threshold | The UTG is offline and the transaction’s amount is above the Stand-in Limit Amount set on the Offline Mode tab in TuneUp or Shift4 Command Center. |
| 9842 | 0 | 40101 | INVALID CARD | Card is invalid--garbage found -OR- CardSwipe is invalid--garbage found | Invalid card number. Card number is non-numeric. |
| 9842 | 0 | 40101 | NOT IN CARDRANGE | Card type not recognized | Card type not recognized for merchant. Or, card type does not start with the expected card range. |
| 9842 | 0 | 40101 | NOT IYC | Card type is not It's Your Card | Attempting a gift card transaction on a non-gift card account. |
| 9846 | 0 | 40103 | BAD UNIQUE ID | Unique Identifier not found for Merchant | Shift4 has no record of the card token being sent by the merchant. If utilizing TOKENSTORE, the card token and its associated card data have been purged from the TOKENSTORE. |
| 9861 | 0 | 40401 | ACCESS DENIED | Global TOKENSTORE permission denied | Serial number is not on the Global TokenStore's allowed list. |
| 9861 | 1 | 40401 | NOT ALLOWED | Cannot send unencrypted card data with P2PE | |
| 9861 | 7 | 40401 | NOT ALLOWED | Cannot send card.token.value with Initialize Readers request | |
| 9862 | 2 | 40101 | AccessToken | AccessToken not found | |
| 9862 | 3 | 40101 | AuthToken | AuthToken not valid | The AuthToken was entered incorrectly into the application or it could have been revoked. |
| 9862 | 4 | 40101 | AuthToken | AuthToken has already been used | A production Auth Token may only be used once. |
| 9862 | 5 | 40101 | AuthToken | Time expired for the AuthToken | The Auth Token was not used in the time allotted by the Lighthouse Transaction Manager Account Administrator. |
| 9951 | 0 | 66202 | RESPONSE TIMEOUT | Timeout waiting for response across the internet | Transaction timeout at data center or processor |
| 9957 | 0 | 52011 | NO HOST | [Text regarding processor varies.] Not connected. | Processor not available. |
| 9960 | 0 | 65100 | INTERNET FAILURE | Transaction timeout with processor | |
| 9961 | 0 | 65100 | INTERNET FAILURE | Transaction timeout [location] | |
| 9961 | 9 | 65100 | INTERNET FAILURE | Transaction timeout [location] | Transaction timeout when processing via PIN Pad |
| 9130 | 0 | 40105 | Token not found | Request cannot be processed, Token not found | |
| 9131 | 0 | 40102 | Auth header | No authorization header found | |
| 9132 | 0 | 40106 | Token expired | Request cannot be processed, Token has expired | |
| 9133 | 0 | 40101 | Invalid token | Request cannot be processed, invalid token | |
| 9126 | 0 | 60000 | SplitToken | Expired split token | |
| 9879 | 0 | 40101 | AMT exceeded | Refund amount greater than original amount | |
| 9505 | 0 | 50102 | Pending | Cancel transaction still in progress | |
| 9505 | 1 | 50102 | Pending | Refund request still in progress | |
| 9506 | 0 | 50102 | Cancel failed | Cancel transaction failed, execute refund transaction | |
| 9815 | 1 | 40104 | Duplicate invoice | Duplicate invoice | |
| 9100 | 2 | 67117 | System Error | Transaction could not be checked against merchant rules. | |
| 9100 | 3 | 67119 | Network Error | Response timeout. | |
| 9100 | 4 | 67121 | Invalid Response | Rules check has returned an invalid value. | |
| 9777 | 1 | 67123 | Trans Failed | Transaction violates merchant rules. |
‡If you are experiencing this critical error in the production environment, contact the Shift4 Support team immediately at 702.597.2480, option 2.