Stripe Decline Codes
When using Stripe to collect payments through your gym management software platform, it’s good to be aware of Stripe’s Decline codes and what they mean.
Below is a list of decline codes, descriptions, and the next steps to take to resolve them. For most up-to-date information visit Stripe Decline Codes.
Stripe Decline Code List
| DECLINE CODE: authentication_required | |
| The card was declined as the transaction requires authentication. | The customer should try again and authenticate their card when prompted during the transaction. If the card issuer returns this decline code on an authenticated transaction, the customer needs to contact their card issuer for more information. |
| DECLINE CODE: approve_with_id | |
| 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. |
| DECLINE CODE: call_issuer | |
| The card has been declined for an unknown reason. | The customer needs to contact their card issuer for more information. |
| DECLINE CODE: 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. |
| DECLINE CODE: card_velocity_exceeded | |
| The customer has exceeded the balance or credit limit available on their card. | The customer should contact their card issuer for more information. |
| DECLINE CODE: 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. |
| DECLINE CODE: do_not_honor | |
| The card has been declined for an unknown reason. | The customer needs to contact their card issuer for more information. |
| DECLINE CODE: do_not_try_again | |
| The card has been declined for an unknown reason. | The customer should contact their card issuer for more information. |
| DECLINE CODE: duplicate_transaction | |
| A transaction with identical amount and credit card information was submitted very recently. | Check to see if a recent payment already exists. |
| DECLINE CODE: expired_card | |
| The card has expired. | The customer should use another card. |
| DECLINE CODE: fraudulent | |
| 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. |
| DECLINE CODE: generic_decline | |
| The card has been declined for an unknown reason. | The customer needs to contact their card issuer for more information. |
| DECLINE CODE: incorrect_number | |
| The card number is incorrect. | The customer should try again using the correct card number. |
| DECLINE CODE: incorrect_cvc | |
| The CVC number is incorrect. | The customer should try again using the correct CVC. |
| DECLINE CODE: incorrect_pin | |
| 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. |
| DECLINE CODE: incorrect_zip | |
| The ZIP/postal code is incorrect. | The customer should try again using the correct billing ZIP/postal code. |
| DECLINE CODE: insufficient_funds | |
| The card has insufficient funds to complete the purchase. | The customer should use an alternative payment method. |
| DECLINE CODE: 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. |
| DECLINE CODE: invalid_amount | |
| 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. |
| DECLINE CODE: invalid_cvc | |
| The CVC number is incorrect. | The customer should try again using the correct CVC. |
| DECLINE CODE: invalid_expiry_month | |
| The expiration month is invalid. | The customer should try again using the correct expiration date. |
| DECLINE CODE: invalid_expiry_year | |
| The expiration year is invalid. | The customer should try again using the correct expiration date. |
| DECLINE CODE: invalid_number | |
| The card number is incorrect. | The customer should try again using the correct card number. |
| DECLINE CODE: invalid_pin | |
| 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. |
| DECLINE CODE: issuer_not_available | |
| 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. |
| DECLINE CODE: lost_card | |
| 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. |
| DECLINE CODE: merchant_blacklist | |
| 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. |
| DECLINE CODE: 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. |
| DECLINE CODE: no_action_taken | |
| The card has been declined for an unknown reason. | The customer should contact their card issuer for more information. |
| DECLINE CODE: not_permitted | |
| The payment is not permitted. | The customer needs to contact their card issuer for more information. |
| DECLINE CODE: offline_pin_required | |
| The card has been declined as it requires a PIN. | The customer should try again by inserting their card and entering a PIN. |
| DECLINE CODE: online_or_offline_pin_required | |
| 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. |
| DECLINE CODE: pickup_card | |
| 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. |
| DECLINE CODE: pin_try_exceeded | |
| The allowable number of PIN tries has been exceeded. | The customer must use another card or method of payment. |
| DECLINE CODE: processing_error | |
| An error occurred while processing the card. | The payment should be attempted again. If it still cannot be processed, try again later. |
| DECLINE CODE: reenter_transaction | |
| 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. |
| DECLINE CODE: restricted_card | |
| 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. |
| DECLINE CODE: revocation_of_all_authorizations | |
| The card has been declined for an unknown reason. | The customer should contact their card issuer for more information. |
| DECLINE CODE: revocation_of_authorization | |
| The card has been declined for an unknown reason. | The customer should contact their card issuer for more information. |
| DECLINE CODE: security_violation | |
| The card has been declined for an unknown reason. | The customer needs to contact their card issuer for more information. |
| DECLINE CODE: service_not_allowed | |
| The card has been declined for an unknown reason. | The customer should contact their card issuer for more information. |
| DECLINE CODE: stolen_card | |
| 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. |
| DECLINE CODE: stop_payment_order | |
| The card has been declined for an unknown reason. | The customer should contact their card issuer for more information. |
| DECLINE CODE: testmode_decline | |
| A Stripe test card number was used. | A genuine card must be used to make a payment. |
| DECLINE CODE: transaction_not_allowed | |
| The card has been declined for an unknown reason. | The customer needs to contact their card issuer for more information. |
| DECLINE CODE: try_again_later | |
| 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. |
| DECLINE CODE: withdrawal_count_limit_exceeded | |
| The customer has exceeded the balance or credit limit available on their card. | The customer should use an alternative payment method. |