If a card issuer declines a payment, they may provide a reason through the use of a decline code. Below is a list of some possible decline codes that can be returned, along with suggestions for next steps to take to try and complete the payment.
DECLINE CODE | DESCRIPTION | NEXT STEPS |
---|---|---|
|
The card was declined as the transaction requires authentication. | The customer should try again and authenticate their card when prompted during the transaction. |
|
The payment cannot be authorized. | The payment should be attempted again. If it still cannot be processed, the customer needs to contact their card issuer. |
|
The card has been declined for an unknown reason. | The customer needs to contact their card issuer for more information. |
|
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. |
|
The customer has exceeded the balance or credit limit available on their card. | The customer should contact their card issuer for more information. |
|
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. |
|
The card has been declined for an unknown reason. | The customer needs to contact their card issuer for more information. |
|
The card has been declined for an unknown reason. | The customer should contact their card issuer for more information. |
|
A transaction with identical amount and credit card information was submitted very recently. | Check to see if a recent payment already exists. |
|
The card has expired. | The customer should use another card. |
|
The payment has been declined as Stripe suspects it is fraudulent. | Do not report more detailed information to your customer. Instead, present as you would the generic_decline described below. |
|
The card has been declined for an unknown reason. | The customer needs to contact their card issuer for more information. |
|
The card number is incorrect. | The customer should try again using the correct card number. |
|
The CVC number is incorrect. | The customer should try again using the correct CVC. |
|
The PIN entered is incorrect. This decline code only applies to payments made with a card reader. | The customer should try again using the correct PIN. |
|
The ZIP/postal code is incorrect. | The customer should try again using the correct billing ZIP/postal code. |
|
The card has insufficient funds to complete the purchase. | The customer should use an alternative payment method. |
|
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. |
|
The payment amount is invalid, or exceeds the amount that is 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. |
|
The CVC number is incorrect. | The customer should try again using the correct CVC. |
|
The expiration year invalid. | The customer should try again using the correct expiration date. |
|
The card number is incorrect. | The customer should try again using the correct card number. |
|
The PIN entered is incorrect. This decline code only applies to payments made with a card reader. | The customer should try again using the correct PIN. |
|
The card issuer could not be reached, so the payment could not be authorized. | The payment should be attempted again. If it still cannot be processed, the customer needs to contact their card issuer. |
|
The payment has been declined because the card is reported lost. | The specific reason for the decline should not be reported to the customer. Instead, it needs to be presented as a generic decline. |
|
The payment has been declined because it matches a value on the Stripe user's block list. | Do not report more detailed information to your customer. Instead, present as you would the generic_decline described above. |
|
The card, or account the card is connected to, is invalid. | The customer needs to contact their card issuer for more information. |
|
The card has been declined for an unknown reason. | The customer should contact their card issuer for more information. |
|
The payment is not permitted. | The customer needs to contact their card issuer for more information. |
|
The card has been declined as it requires a PIN. | The customer should try again by inserting their card and entering a PIN. |
|
The card has been declined as it requires a PIN. | If the card reader supports Online PIN, the customer should be prompted for a PIN without a new transaction being created. If the card reader does not support Online PIN, the customer should try again by inserting their card and entering a PIN. |
|
The card cannot be used to make this payment (it is possible it has been reported lost or stolen). | The customer needs to contact their card issuer for more information. |
|
The allowable number of PIN tries has been exceeded. | The customer must use another card or method of payment. |
|
An error occurred while processing the card. | The payment should be attempted again. If it still cannot be processed, try again later. |
|
The payment could not be processed by the issuer for an unknown reason. | The payment should be attempted again. If it still cannot be processed, the customer needs to contact their card issuer. |
|
The card cannot be used to make this payment (it is possible it has been reported lost or stolen). | The customer needs to contact their card issuer for more information. |
|
The card has been declined for an unknown reason. | The customer should contact their card issuer for more information. |
|
The card has been declined for an unknown reason. | The customer should contact their card issuer for more information. |
|
The card has been declined for an unknown reason. | The customer needs to contact their card issuer for more information. |
|
The card has been declined for an unknown reason. | The customer should contact their card issuer for more information. |
|
The payment has been declined because the card is reported stolen. | The specific reason for the decline should not be reported to the customer. Instead, it needs to be presented as a generic decline. |
|
The card has been declined for an unknown reason. | The customer should contact their card issuer for more information. |
|
A Stripe test card number was used. | A genuine card must be used to make a payment. |
|
The card has been declined for an unknown reason. | The customer needs to contact their card issuer for more information. |
|
The card has been declined for an unknown reason. | Ask the customer to attempt the payment again. If subsequent payments are declined, the customer should contact their card issuer for more information. |
|
The customer has exceeded the balance or credit limit available on their card. | The customer should use an alternative payment method. |