Stripe Decline Codes

We use payment optimzation engines to recover more revenue. Card payments can fail for a variety of reasons. Some of the most common are:

Download our app

Decline Code

Description

Next steps

Status

authentication_required

The card was declined because the transaction requires authentication such as 3D Secure.

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 decline code despite a successfully authenticated transaction, the customer needs to contact their card issuer for more information.

Hard decline

authentication_required

The card was declined because the transaction requires authentication such as 3D Secure.

Hard decline

authentication_required

The card was declined because the transaction requires authentication such as 3D Secure.

Hard decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

call_issuer

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

call_issuer

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

call_issuer

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

do_not_honor

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

do_not_honor

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

do_not_honor

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

do_not_try_again

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

do_not_try_again

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

do_not_try_again

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

duplicate_transaction

A transaction with identical amount and credit card information was submitted very recently.

Check to see if a recent payment already exists.

Soft decline

duplicate_transaction

A transaction with identical amount and credit card information was submitted very recently.

Check to see if a recent payment already exists.

Soft decline

duplicate_transaction

A transaction with identical amount and credit card information was submitted very recently.

Check to see if a recent payment already exists.

Soft decline

expired_card

The card has expired.

The customer needs to use another card.

Soft decline

expired_card

The card has expired.

The customer needs to use another card.

Soft decline

expired_card

The card has expired.

The customer needs to use another card.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

generic_decline

The card was declined for an unknown reason or Stripe Radar blocked the payment.

The customer needs to contact their card issuer for more information.

Soft decline

generic_decline

The card was declined for an unknown reason or Stripe Radar blocked the payment.

The customer needs to contact their card issuer for more information.

Soft decline

generic_decline

The card was declined for an unknown reason or Stripe Radar blocked the payment.

The customer needs to contact their card issuer for more information.

Soft decline

incorrect_number

The card number is incorrect.

The customer needs to try again using the correct card number.

Hard decline

incorrect_number

The card number is incorrect.

The customer needs to try again using the correct card number.

Hard decline

incorrect_number

The card number is incorrect.

The customer needs to try again using the correct card number.

Hard decline

incorrect_cvc

The CVC number is incorrect.

The customer needs to try again using the correct CVC.

Soft decline

incorrect_cvc

The CVC number is incorrect.

The customer needs to try again using the correct CVC.

Soft decline

incorrect_cvc

The CVC number is incorrect.

The customer needs to try again using the correct CVC.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

incorrect_zip

The postal code is incorrect.

The customer needs to try again using the correct billing postal code.

Soft decline

incorrect_zip

The postal code is incorrect.

The customer needs to try again using the correct billing postal code.

Soft decline

incorrect_zip

The postal code is incorrect.

The customer needs to try again using the correct billing postal code.

Soft decline

insufficient_funds

The card has insufficient funds to complete the purchase.

The customer needs to use an alternative payment method.

Soft decline

insufficient_funds

The card has insufficient funds to complete the purchase.

The customer needs to use an alternative payment method.

Soft decline

insufficient_funds

The card has insufficient funds to complete the purchase.

The customer needs to use an alternative payment method.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

invalid_cvc

The CVC number is incorrect.

The customer needs to try again using the correct CVC.

Soft decline

invalid_cvc

The CVC number is incorrect.

The customer needs to try again using the correct CVC.

Soft decline

invalid_cvc

The CVC number is incorrect.

The customer needs to try again using the correct CVC.

Soft decline

invalid_expiry_month

The expiration month is invalid.

The customer needs to try again using the correct expiration date.

Soft decline

invalid_expiry_month

The expiration month is invalid.

The customer needs to try again using the correct expiration date.

Soft decline

invalid_expiry_month

The expiration month is invalid.

The customer needs to try again using the correct expiration date.

Soft decline

invalid_expiry_year

The expiration year is invalid.

The customer needs try again using the correct expiration date.

Soft decline

invalid_expiry_year

The expiration year is invalid.

The customer needs try again using the correct expiration date.

Soft decline

invalid_expiry_year

The expiration year is invalid.

The customer needs try again using the correct expiration date.

Soft decline

invalid_number

The card number is incorrect.

The customer needs try again using the correct card number.

Soft decline

invalid_number

The card number is incorrect.

The customer needs try again using the correct card number.

Soft decline

invalid_number

The card number is incorrect.

The customer needs try again using the correct card number.

Soft decline

invalid_pin

The PIN entered is incorrect.

The customer needs to try again using the correct PIN.

Soft decline

invalid_pin

The PIN entered is incorrect.

The customer needs to try again using the correct PIN.

Soft decline

invalid_pin

The PIN entered is incorrect.

The customer needs to try again using the correct PIN.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Hard decline

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.

Hard decline

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.

Hard 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.

Soft 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.

Soft 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.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

no_action_taken

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

no_action_taken

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

no_action_taken

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

not_permitted

The payment isn't permitted.

The customer needs to contact their card issuer for more information.

Soft decline

not_permitted

The payment isn't permitted.

The customer needs to contact their card issuer for more information.

Soft decline

not_permitted

The payment isn't permitted.

The customer needs to contact their card issuer for more information.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

online_or_offline_pin_required

The card was declined as it requires a PIN.

Soft decline

online_or_offline_pin_required

The card was declined as it requires a PIN.

Soft decline

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.

Hard decline

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.

Hard decline

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.

Hard decline

pin_try_exceeded

The allowable number of PIN tries was exceeded.

The customer must use another card or method of payment.

Soft decline

pin_try_exceeded

The allowable number of PIN tries was exceeded.

The customer must use another card or method of payment.

Soft decline

pin_try_exceeded

The allowable number of PIN tries was exceeded.

The customer must use another card or method of payment.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

revocation_of_all_authorizations

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Hard decline

revocation_of_all_authorizations

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Hard decline

revocation_of_all_authorizations

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Hard decline

revocation_of_authorization

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Hard decline

revocation_of_authorization

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Hard decline

revocation_of_authorization

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Hard decline

security_violation

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

security_violation

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

security_violation

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

service_not_allowed

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

service_not_allowed

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

service_not_allowed

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

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.

Hard decline

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.

Hard decline

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.

Hard decline

stop_payment_order

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

stop_payment_order

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

stop_payment_order

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

testmode_decline

A Stripe test card number was used.

A genuine card must be used to make a payment.

Soft decline

testmode_decline

A Stripe test card number was used.

A genuine card must be used to make a payment.

Soft decline

testmode_decline

A Stripe test card number was used.

A genuine card must be used to make a payment.

Soft decline

transaction_not_allowed

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

transaction_not_allowed

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

transaction_not_allowed

The card was declined for an unknown reason.

The customer needs to contact their card issuer for more information.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

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.

Soft decline

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.