Decline codes

learn about decline codes and how to resolve them when a charge fails a decline code is typically a two digit, alphanumeric error code that indicates a reason for the decline while the code can originate from a number of sources, it often comes from the issuing bank, payment processor, or credit network stripe decline codes stripe uses its own decline codes, which cover many of the same potential reasons as the traditional decline codes, but define the problem more clearly use the following table to help resolve issues relating to decline codes decline code description next steps authentication required the card was declined because the transaction requires authentication such as when using stripe’s front ends, in most cases a soft decline from an issuer triggers an authentication flow, allowing the customer to try again and authenticate their card in some cases, such as off session payments, you might need to request the customer to retry if the card issuer returns this despite a successfully authenticated transaction, the customer needs to contact their card issuer for more information approve with id the payment can’t be authorized attempt the payment again if you still can’t process it, the customer needs to contact their card issuer call issuer the card was declined for an unknown reason the customer needs to contact their card issuer for more information card not supported the card does not support this type of purchase the customer needs to contact their card issuer to make sure their card can be used to make this type of purchase card velocity exceeded the customer has exceeded the balance, credit limit, or transaction amount limit available on their card the customer needs to contact their card issuer for more information currency not supported the card does not support the specified currency the customer needs to check with the issuer whether the card can be used for the type of currency specified do not honor the card was declined for an unknown reason the customer needs to contact their card issuer for more information do not try again the card was declined for an unknown reason the customer needs to contact their card issuer for more information duplicate transaction a transaction with identical amount and credit card information was submitted very recently check to see if a recent payment already exists expired card the card has expired the customer needs to use another card fraudulent the payment was declined because stripe suspects that it’s fraudulent don’t report more detailed information to your customer instead, present it in the same manner as generic decline below generic decline the card was declined for an unknown reason or stripe radar the customer needs to contact their card issuer for more information incorrect number the card number is incorrect the customer needs to try again using the correct card number incorrect cvc the cvc number is incorrect the customer needs to try again using the correct cvc incorrect pin the pin entered is incorrect this decline code only applies to payments made with a card reader the customer needs to try again using the correct pin incorrect zip the postal code is incorrect the customer needs to try again using the correct billing postal code insufficient funds the card has insufficient funds to complete the purchase the customer needs to use an alternative payment method invalid account the card, or account the card is connected to, is invalid the customer needs to contact their card issuer to check that the card is working correctly invalid amount the payment amount is invalid, or exceeds the amount that’s allowed if the amount appears to be correct, the customer needs to check with their card issuer that they can make purchases of that amount invalid cvc the cvc number is incorrect the customer needs to try again using the correct cvc invalid expiry month the expiration month is invalid the customer needs to try again using the correct expiration date invalid expiry year the expiration year is invalid the customer needs try again using the correct expiration date invalid number the card number is incorrect the customer needs try again using the correct card number invalid pin the pin entered is incorrect the customer needs to try again using the correct pin issuer not available the card issuer couldn’t be reached, so the payment couldn’t be authorized attempt the payment again if you still can’t process it, the customer needs to contact their card issuer lost card the payment was declined because the card is reported lost the specific reason for the decline shouldn’t be reported to the customer instead, present it as a generic decline merchant blacklist the payment was declined because it matches a value on the stripe user’s block list don’t report more detailed information to your customer instead, present it in the same manner as generic decline below new account information available the card, or account the card is connected to, is invalid the customer needs to contact their card issuer for more information no action taken the card was declined for an unknown reason the customer needs to contact their card issuer for more information not permitted the payment isn’t permitted the customer needs to contact their card issuer for more information offline pin required the card was declined because it requires a pin the customer needs to try again by inserting their card and entering a pin online or offline pin required the card was declined as it requires a pin if the card reader supports online pin, prompt the customer for a pin without creating a new transaction if the card reader doesn’t support online pin, the customer needs to try again by inserting their card and entering a pin pickup card the customer can’t use this card to make this payment (it’s possible it was reported lost or stolen) they need to contact their card issuer for more information pin try exceeded the allowable number of pin tries was exceeded the customer must use another card or method of payment processing error an error occurred while processing the card the payment needs to be attempted again if it still can’t be processed, try again later reenter transaction the payment couldn’t be processed by the issuer for an unknown reason the payment needs to be attempted again if it still can’t be processed, the customer needs to contact their card issuer restricted card the customer can’t use this card to make this payment (it’s possible it was reported lost or stolen) the customer needs to contact their card issuer for more information revocation of all authorizations the card was declined for an unknown reason the customer needs to contact their card issuer for more information revocation of authorization the card was declined for an unknown reason the customer needs to contact their card issuer for more information security violation the card was declined for an unknown reason the customer needs to contact their card issuer for more information service not allowed the card was declined for an unknown reason the customer needs to contact their card issuer for more information stolen card the payment was declined because the card is reported stolen don’t report more detailed information to your customer instead, present it in the same manner as generic decline below stop payment order the card was declined for an unknown reason the customer needs to contact their card issuer for more information testmode decline a stripe test card number was used a genuine card must be used to make a payment transaction not allowed the card was declined for an unknown reason the customer needs to contact their card issuer for more information try again later the card was declined for an unknown reason ask the customer to attempt the payment again if subsequent payments are declined, the customer needs to contact their card issuer for more information withdrawal count limit exceeded the customer has exceeded the balance or credit limit available on their card the customer needs to use an alternative payment method