Card Payment Error Codes

Card Payment Error Codes

HTTP Response

When a card payment is declined due to an issuer rejection, the checkout API returns an HTTP 400 response. This is an expected response code indicating that the payment was not approved.

The response body contains the following fields:

FieldTypeDescription
msgstringA short description of the decline reason.
protectionbooleanWhether chargeback protection applies to this transaction.
paymentIdstringThe unique identifier for the payment attempt.
codestringThe issuer decline code (see table below).
titlestringA short title describing the decline reason.
messagestringA detailed message explaining the decline.
actionstringA recommended action for the customer to resolve the issue.
debugIdstringA unique identifier for debugging purposes.

Example Response

1{
2 "msg": "The transaction is suspected of fraud.",
3 "protection": false,
4 "paymentId": "d19f82b2-214e-49cc-9f9b-07398c91cda9",
5 "code": "59",
6 "title": "Suspected Fraud",
7 "message": "The transaction is suspected of fraud.",
8 "action": "Contact your bank to confirm the legitimacy of the transaction and request approval.",
9 "debugId": "9d3698c43eda078c793c65b50fd05c90"
10}

Bank/Network Error Codes

CodeTitleMessageAction
01Refer to IssuerYour transaction has been declined.Call the phone number on the back of your credit card to speak with your bank and inquire about the decline.
02Refer to Issuer, Special ConditionThis transaction requires special authorization.Call your bank using the phone number on the back of your credit card to discuss the specific details of this transaction.
03Invalid GatewayTechnical issue at your bank. Try again later.Due to a technical issue at your bank, this transaction was declined. Please try again later.
04Pickup CardYour card has been reported lost or stolen.Call your bank to report the issue and request a replacement card.
05Do Not HonorSorry, your card cannot be authorized at this time.Call your bank to inquire about the reason for the decline and seek guidance on resolving the issue.
06ErrorYour transaction has been declined.Retry the transaction, and if the issue persists, contact your bank for further assistance.
07Pick Up Card, Special ConditionYour card has been reported as lost or stolen, and special conditions apply.Call your bank to report the issue and discuss the special conditions for resolution.
10Partial ApprovalYour transaction has been partially approved. Please use another payment method for the remaining amount.Use an alternative payment method for the remaining balance of your purchase.
12Invalid TransactionThe transaction is invalid.Review the transaction details and try again. If the problem persists, contact your bank for support.
13Invalid AmountThe transaction amount is invalid.Verify the transaction amount and try again. If the issue persists, contact your bank for clarification.
14Invalid Card NumberThe card number entered is invalid.Verify and re-enter the card number. If the problem persists, contact your bank for guidance.
15No Such IssuerThe card issuer is not recognized.Call your bank to ensure that your card information is correct and that there are no issues with your account.
19Re-enter Last TransactionPlease re-enter your last transaction.Retry the transaction. If the problem continues, reach out to your bank for further guidance.
25Unable to Locate RecordUnable to locate the record. Please verify your card details or contact your card issuer for assistance.Double-check your card details and try again. If the issue persists, contact your bank for support.
28File is Temporarily UnavailableThe file necessary for processing is temporarily unavailable. Please try again later or contact your card issuer.Wait for some time and try the transaction again. If the problem persists, contact your bank for assistance.
33Expired CardYour card has expired. Please use a valid card for this transaction.Check the expiration date on your card and use a valid card for the transaction.
41Lost Card, Pick UpYour card has been reported as lost. Please contact your bank to resolve the issue.Call your bank immediately to report the lost card and request a replacement.
43Stolen Card, Pick UpYour card has been reported as stolen. Please contact your bank to resolve the issue.Call your bank immediately to report the stolen card and request a replacement.
46Account ClosedThis Account is Closed. Please contact your bank for assistance.Call your bank to inquire about why your accout with them is no longer active.
51Insufficient FundsThere are not enough funds in your account to complete this transaction.Check your account balance and, if necessary, add funds to your account. Alternatively, use a different payment method.
54Expired CardYour card has expired. Please use a valid card for this transaction.Check the expiration date on your card and use a valid card for the transaction.
5CTransaction Not SupportedThis transaction type is not supported or has been blocked by your card issuer.Call your bank to verify whether this type of transaction is supported on your card.
57Transaction Not Permitted to CardholderThis type of transaction is not permitted on your card.Call your bank to verify the restrictions on your card and seek guidance on how to proceed.
58Transaction Not Permitted to CardholderThis type of transaction is not permitted on your card.Call your bank to verify the restrictions on your card and seek guidance on how to proceed.
59Suspected FraudThe transaction is suspected of fraud.Contact your bank to confirm the legitimacy of the transaction and request approval.
61Exceeds Withdrawal LimitThe transaction exceeds the withdrawal limit on your account.Please choose a different payment method or contact your bank for a limit increase.
62Card not activatedCard not activated yetThis is the first use of a new card which you have not activated yet. Please call the number on the card to activate your card.
63Security ViolationThe transaction has been declined due to a security violation. Please contact your card issuer for resolution.Contact your bank to discuss the security violation and seek guidance on how to resolve the issue.
65Decline Activity Limit ExceededTransaction declined due to activity limits being exceeded. For security reasons, please contact your card issuer.Reach out to your bank to discuss the decline and verify if there are any activity limits in place on your account.
70Contact Card IssuerYour card issuer needs to speak with you before this transaction can be approved.Call your bank using the phone number on the back of your card to resolve the issue, then try again.
72Account Not Yet ActivatedThis account has not been activated yet.Contact your bank to activate your card before attempting to use it for transactions.
78Blocked AccountYour account has been blocked. Please contact your card issuer for assistance.Call your bank to inquire about the account block and seek guidance on how to resolve the issue.
82CVV MismatchThe CVV provided does not match.Double-check the CVV (Card Verification Value) on the back of your card and ensure it matches the one provided during the transaction.
83Fraud/SecurityDecline due to fraud/secuirty suspicion.Please retry your purchase, or contact your bank for assistance.
88System MalfunctionThere is a system malfunction. Please try again later or contact your card issuer for assistance.Wait for some time and try the transaction again. If the problem persists, contact your bank for support.
91Issuer or Switch is InoperativeThe card issuer or switch is temporarily inoperative. Please try again later or contact your card issuer for assistance.Wait for some time and try the transaction again. If the problem persists, contact your bank for support.
93Violation, Cannot CompleteThe transaction cannot be completed due to a violation. Please contact your card issuer for assistance.Contact your bank to discuss the violation and seek guidance on how to complete the transaction.
97CVV MismatchThe CVV provided does not match.Double-check the CVV (Card Verification Value) on the back of your card and ensure it matches the one provided during the transaction.
96System MalfunctionThere is a system malfunction. Please try again later or contact your card issuer for assistance.Wait for some time and try the transaction again. If the problem persists, contact your bank for support.
99Invalid InputThe information you entered was invalid.Please check the credit card number, CVV, and expiration date and resubmit.
340Card is lockedYour card is locked or restricted by you or your bank.Unlock the card in your banking app, or call your bank to lift the restriction. Then try again.
103Fraud SuspicionThe transaction is suspected of fraud.Contact your bank to confirm the legitimacy of the transaction and request approval.
999Failed Chargeback Protection ChecksYour purchase was declined, and no charges were made.Any pending transactions will disappear from your bank statement within 24 hours.
N7CVV MismatchThe CVV provided does not match.Double-check the CVV (Card Verification Value) on the back of your card and ensure it matches the one provided during the transaction.
9983DS RejectedYour Bank Rejected the RequestPlease contact your bank support to resolve the issue.
997User Failed 3DS ChallengeFailed ChallengePlease retry the purchase or try a different card.
886Country not supportedCards issued in your country are not supported.Please try a different card.
887Apple Pay/Google Pay is currently not available. Please enter your card details manuallyApple Pay/Google Pay is currently not available. Please enter your card details manuallyPlease enter your card details manually
888Address Verification FailureAddress does not match cards billing addressPlease enter the cards billing address and try again
889Card Brand Not SupportedCard Brand is not supportedPlease use a different card brand and try again.
9GTransaction Frequency Limit ExceededToo many transactions attempted in a short period.Please wait a few minutes before attempting another transaction, or contact your bank for assistance.
8703DS Verification FailedCard has failed 3DS recentlyPlease try a different card or wait a few minutes before retrying. If the issue persists, contact your bank.
871Payment Method BlockedPayment method is blockedThis payment method cannot be used. Please use a different card or payment method.
872Payment Method in UsePayment method is associated with another accountThis payment method cannot be used. It is associated with another account. Please use a different card or payment method.
873Name Verification FailedName on card does not matchPlease ensure the name on your card matches your account information exactly.
874Daily Purchase Limit ReachedCustomer has reached daily purchase limitYou have reached the daily purchase limit. Please try again tomorrow or contact support for assistance.
875Unsupported CountryThis card cannot be used.Please use a card issued from a different country
876Unsupported StateBilling address indicates this transaction is from an unsupported state.Transaction not allowed.
877Unsupported State By IPGeolocation indicates this transaction is from an unsupported state.Transaction not allowed.
878Unsupported LocationBrowser-reported location indicates this transaction is from an unsupported region.Transaction not allowed.