Errors
| Error code | HTTP code | Error code group | Error code name | Error code name |
|---|---|---|---|---|
| 0 | 200 | No Error | Success | Successful operation. |
| 1000 | 200 | Issuer Error | Decline with no reason. | Issuer error. Issuer declined the transaction, but the issuing bank couldn’t identify a specific problem. When no other decline codes represent the reason for the decline.There’s no apparent problem, but something still went wrong. This error is sort of a catch-all. Try it again. Recommended Action: Attempt can occur within same day. If it still can’t be processed, the customer needs to contact their card issuer |
| 1001 | 200 | Issuer Error | Incorrect CVV2/CVC2 | Issuer error. Incorrect CVV.Used to indicate that Authorization request didn’t pass CVV2 verification.Errors like 'Decline for CVV2 failure'. Recommended Action:** Validate the CVV2 value prior to reattempt. |
| 1002 | 200 | Issuer Error | Expired card | Issuer error. Incorrect card expiration date.Card or Payment Method is expired, expiration date is invalid or expiry date not provided.Errors like 'Expired card or expiration date missing' .Recommended Action: Validate the expiration date prior to reattempt |
| 1003 | 200 | Issuer Error | Issuer not available | Issuer error. Issuer is not available at the moment.Issuer is temporarily unable to respond. (payment system’s failover service not applicable or available for this transaction).Errors like 'Issuer or switch inoperative'. Recommended Action: Attempt can occur within same day. |
| 1004 | 200 | Issuer Error | Not permitted | Issuer error. Operation is not allowed.Used for unsupported transaction types or permanent restrictions not classified under other response codes. Errors like 'Do not honor' /Only permitted only when no other decline codes represent the reason for the decline./, 'Transaction not permitted to cardholder' /For restrictions placed at the Bank Identification Number (BIN) level (product or product BIN range) and not at the cardholder (account) level (e.g., government programs for funds may be used only for specific types of transactions like food stamps)./ Recommended Action: Request alternate payment method from cardholder and/or advise the cardholder to contact their issuer |
| 1005 | 200 | Issuer Error | Technical error | Issuer error. Error on funds authorization. May be used by the issuer or issuer processor to indicate that their system is unable perform the authorization due to system malfunction or critical message failure. Errors like 'System malfunction' /An issuer’s authorization system is unavailable due to communication lines down or system time-out. The issuer switch usually generates this response./. Recommended Action: Attempt can occur within same day.. |
| 1006 | 200 | Issuer Error | Insufficient funds | Issuer error. Not enough funds.Transaction amount exceeds the cardholders available balance.Errors like 'Not sufficient funds' /For credit: The cardholder has reached the credit card limit. For debit: The cardholder does not have available funds in the associated checking or savings account./ Recommended Action: May reattempt for a lesser amount or at a later date to allow the customer to fund their debit account or pay down their credit account. |
| 1007 | 200 | Issuer Error | Limit exceeded | Issuer error. Some limits exceeded.The amount/count activity limit for the card or account has been exceeded or The Issuer or Acquirer Settlement Risk Exposure Cap has been exceeded.Errors like 'Exceeds approval amount/count' /The defined amount/count activity limit for the card or account (usually set daily) is exceeded./ Recommended Action: Do not reattempt the transaction the same day to allow limits to reset. |
| 1008 | 200 | Issuer Error | Suspected fraud | Issuer error. Fraud suspicion.Used when a transaction fails a fraud rule in the Issuers fraud detection system or in the payment system. Errors like 'Lost card, pick up', 'Stolen card, pick up', 'Suspected fraud' /Declining a transaction due to suspected fraud. VisaNet converts all these responses to error code 1004 before sending the authorization response back to the merchant/ Recommended Action: Advise the cardholder to contact their issuer and do not reattempt he transaction until the cardholder confirms. |
| 1009 | 200 | Issuer Error | Invalid account | Issuer error. Verify card data.Account number was never issued or has been permanently blocked or closed. Errors like 'Invalid account number (no such number)' /The card has been issued but not yet activated. Also this code may be used if a uniquely associated account cannot be determined./ Recommended Action: Reattempt not permitted with the same PAN or token. Revalidate account number for accuracy. |
| 2000 | 200 | Processor Error | Settings error | Payment system error. Settings error.The transaction was rejected due to incorrect settings of the merchant’s account on the payment system side. Recommended Action: Attempt can occur within same day. |
| 2001 | 200 | Processor Error | Format error | Payment system error. Format error.Transaction temporarily cannot be processed. Used when the acquirer or the payment system is temporarily unable to process a transaction due to an error in the message structure or field format. Recommended Action: Attempt can occur within same day. |
| 2002 | 200 | Processor Error | Technical error | Payment system error. Technical error for internal configuration purpose..The transaction is not authorized due to technical issues on the payment system side. The issuer couldn’t be reached, so the payment couldn’t be authorized. Recommended Action: Attempt can occur within same day. |
| 2003 | 200 | Processor Error | Technical error | Payment system error.Technical error for internal configuration purpose..The transaction is not authorized due to technical issues on the payment system side. The issuer couldn’t be reached, so the payment couldn’t be authorized. Recommended Action: Attempt can occur within same day. |
| 2004 | 200 | Processor Error | Timeout error | Payment system error. Gateway Timeout error.The transaction is not authorized due to network issues on the payment system side. The issuer couldn’t be reached, so the payment couldn’t be authorized. Recommended Action: Attempt can occur within same day.. |
| 3000 | 200 | Additional Auth Error | Success | Additional (3-D Secure, OTP, etc..) authentication not passed or the client did not pay within a reasonable time. |
| 3001 | 200 | Additional Auth Error | Technical error | Technical error on authentication (3-D Secure, OTP, etc..). |
| 3002 | 200 | Additional Auth Error | Auth error | Additional (3-D Secure, OTP, etc..) authentication failed. The client entered an incorrect password or refused |
| 4000 | 200 | Antifraud Error | Antifraud | Rejected by fraud monitoring. |
| 4001 | 200 | Antifraud Error | Antifraud | Merchant limit exceeded. |
| 4002 | 200 | Antifraud Error | Antifraud | Rejected by fraud monitoring. |
| 4003 | 200 | Antifraud Error | Antifraud | Rejected by fraud monitoring. |
| 5000 | 502 | Internal Error | Network error | Network error. (please look at the transaction status) |
| 5001 | 400 | Internal Error | Format error | Format Error. Your request is not parseable. |
| 5002 | 401 | Internal Error | Unauthorized | Your merchant account is not configured for the transaction you attempted. |
| 5003 | 402 | Internal Error | Request declined | Your transaction request has been declined for internal reason. |
| 5004 | 403 | Internal Error | Forbidden | The credentials provided with the request do not have permission to access the requested data. |
| 5005 | 404 | Internal Error | Not found | The ID(s) specified in the URL do not correspond to the values in the system. |
| 5007 | 415 | Internal Error | Unsupported media type | Expected content type header application/json. |
| 5008 | 409 | Internal Error | Conflict | The transaction you have submitted has already been processed. (please look at the transaction status) |
| 5009 | 429 | Internal Error | Too many requests | The API call has been denied as it has exceeded the permissible call rate limit. A concurrent transaction is currently active. Try again later |
| 5010 | 500 | Internal Error | Internal server error | An internal error occurred. (please look at the transaction status) |
| 5011 | 502 | Internal Error | Bad gateway | An error occurred with the external processing gateway. (please look at the transaction status) |
| 5012 | 401 | Internal Error | Route not found | Route not found. |
| 5013 | 400 | Internal Error | Invalid input | Invalid input |
| 5014 | 401 | Internal Error | Invalid token | Invalid token |
| 5015 | 401 | Internal Error | Expired token | Expired token |
| 5016 | 402 | Internal Error | Invalid order status | Invalid order status |
| 5017 | 429 | Internal Error | Check transaction status later | Check transaction status later |
| 5018 | 400 | Internal Error | Decryption error | Decryption error |
| 5019 | 400 | Internal Error | Invalid card parameter | Invalid card parameter |
| 5020 | 401 | Internal Error | Invalid credentials | Invalid credentials |
| 5901 | 503 | Internal Error | Service unavailable | Service temporarily unavailable. Try again later. (please look at the transaction status).(psp-supervisor) |
| 5902 | 503 | Internal Error | Service unavailable | Service temporarily unavailable. Try again later. (please look at the transaction status).(psp-api-listener) |
| 5903 | 503 | Internal Error | Service unavailable | Service temporarily unavailable. Try again later. (please look at the transaction status).(psp-antifraud) |
| 5904 | 503 | Internal Error | Service unavailable | Service temporarily unavailable. Try again later. (please look at the transaction status).(psp-balance) |
| 5905 | 503 | Internal Error | Service unavailable | Service temporarily unavailable. Try again later. (please look at the transaction status).(psp-cardadapter) |
| 5906 | 503 | Internal Error | Service unavailable | Service temporarily unavailable. Try again later. (please look at the transaction status).(psp-cardinfo) |
| 5907 | 503 | Internal Error | Service unavailable | Service temporarily unavailable. Try again later. (please look at the transaction status).(psp-commission) |
| 5908 | 503 | Internal Error | Service unavailable | Service temporarily unavailable. Try again later. (please look at the transaction status).(psp-crypto) |
| 5909 | 503 | Internal Error | Service unavailable | Service temporarily unavailable. Try again later. (please look at the transaction status).(psp-dbupdater) |
| 5910 | 503 | Internal Error | Service unavailable | Service temporarily unavailable. Try again later. (please look at the transaction status).(psp-payment-adapter) |
| 5911 | 503 | Internal Error | Service unavailable | Service temporarily unavailable. Try again later. (please look at the transaction status).(psp-publickey) |
| 5912 | 503 | Internal Error | Service unavailable | Service temporarily unavailable. Try again later. (please look at the transaction status).(psp-router) |
| 5913 | 503 | Internal Error | Service unavailable | Service temporarily unavailable. Try again later. (please look at the transaction status).(psp-scheduler) |
| 5914 | 503 | Internal Error | Service unavailable | Service temporarily unavailable. Try again later. (please look at the transaction status).(psp-tokenization) |
| 5998 | 503 | Internal Error | Service unavailable | Service temporarily unavailable. Try again later. (please look at the transaction status).(Kafka) |
| 5999 | 503 | Internal Error | Service unavailable | Service temporarily unavailable. Try again later. (please look at the transaction status). |