Decline Decoder

Stripe Decline Codes, Explained

All 50 Stripe card decline codes in plain English: what each one means, whether a retry can work, and what to do next. Grouped by cause.

Get the free fix sheet (PDF)Failed-payment calculator

Wrong or invalid card details

CodeMeaningRetry
expired_cardThe card is past its expiration date.Retry won't fix it
incorrect_addressThe address the customer entered doesn't match.Retry won't fix it
incorrect_cvcThe security code (CVC) is wrong.Retry won't fix it
incorrect_numberThe card number is wrong.No automatic retry
incorrect_zipThe billing postal code is wrong.Retry won't fix it
invalid_cvcThe security code (CVC) is wrong.Retry won't fix it
invalid_expiry_monthThe month in the expiry date was rejected as invalid.Retry won't fix it
invalid_expiry_yearThe year in the expiry date was rejected as invalid.Retry won't fix it
invalid_numberThe card number is wrong.Retry won't fix it
new_account_information_availableThe card, or the account behind it, isn't valid.Retry won't fix it

Funds and limits

CodeMeaningRetry
card_velocity_exceededThe customer went over the balance, credit limit or transaction limit on the card.Retry may work
insufficient_fundsThere isn't enough money or credit on the card to cover the payment.Retry may work
withdrawal_count_limit_exceededThe customer went over the balance or credit limit on the card.Retry may work

The bank said no

CodeMeaningRetry
approve_with_idThe bank couldn't authorize the payment.Retry possible, often needs the customer
call_issuerThe bank declined and didn't say why.Retry possible, often needs the customer
card_not_supportedThis card can't be used for this kind of purchase.Retry possible, often needs the customer
currency_not_supportedThe card doesn't work with the currency you charged in.Retry possible, often needs the customer
do_not_honorThe bank declined for a reason it didn't share.Retry possible, often needs the customer
generic_declineThe bank declined for an unknown reason, or Stripe's fraud tools (Radar or Adaptive Acceptance) blocked the payment.Retry possible, often needs the customer
invalid_accountThe card, or the account behind it, isn't valid.Retry possible, often needs the customer
invalid_amountThe amount isn't valid or is more than the card allows.Retry possible, often needs the customer
no_action_takenThe bank declined for an unshared reason.Retry possible, often needs the customer
not_permittedThe payment isn't allowed.Retry possible, often needs the customer
revocation_of_all_authorizationsThe bank declined for an unshared reason.No automatic retry
revocation_of_authorizationThe bank declined for an unshared reason.No automatic retry
service_not_allowedThe bank declined for an unshared reason.Retry possible, often needs the customer
stop_payment_orderThe bank declined for an unshared reason.Retry possible, often needs the customer
transaction_not_allowedThe bank declined for an unshared reason.No automatic retry

Fraud, lost or stolen

CodeMeaningRetry
fraudulentStripe suspects the payment is fraudulent.Retry possible, often needs the customer
lost_cardThe card has been reported lost.No automatic retry
merchant_blacklistThe payment matched an entry on your own Stripe block list.Retry possible, often needs the customer
pickup_cardThe customer can't use this card for this payment. It may have been reported lost or stolen.No automatic retry
restricted_cardThe customer can't use this card for this payment. It may have been reported lost or stolen.Retry possible, often needs the customer
security_violationThe bank declined for an unshared reason.Retry possible, often needs the customer
stolen_cardThe card has been reported stolen.No automatic retry

Authentication needed

CodeMeaningRetry
authentication_requiredThe bank wants the cardholder to verify the payment, for example with 3D Secure, before it will approve it.No automatic retry
authentication_not_handledThe bank asked for authentication, the payment went ahead without it, and the bank declined again.Needs the customer
mobile_device_authentication_requiredThe bank wants the payment confirmed on the customer's phone or wallet.Needs the customer

Temporary or processing problems

CodeMeaningRetry
duplicate_transactionA payment with the same amount and card details was sent moments ago.Retry may work
issuer_not_availableStripe couldn't reach the bank to get an approval.Retry may work
processing_errorSomething went wrong while the card was being processed.Retry may work
reenter_transactionThe bank couldn't process the payment for an unknown reason.Retry may work

In-person card reader (PIN)

CodeMeaningRetry
incorrect_pinThe PIN is wrong. This code only applies to payments taken on a card reader.Fix at the reader
invalid_pinThe PIN is wrong.Fix at the reader
offline_pin_requiredThe card needs a PIN for this payment.Fix at the reader
online_or_offline_pin_requiredThe card needs a PIN for this payment.Fix at the reader
pin_try_exceededToo many wrong PIN attempts.Fix at the reader

Setup, testing and deprecated codes

CodeMeaningRetry
do_not_try_againThe bank declined for an unshared reason. Stripe marks this code as deprecated.Retry possible, often needs the customer
testmode_declineThe payment used one of Stripe's test card numbers, which can't make real charges.Retry possible, often needs the customer
try_again_laterThe bank declined for an unshared reason. Stripe marks this code as deprecated.Retry possible, often needs the customer

More references

Checked against Stripe's public docs on November 17, 2026. Codes and guidance can change; always confirm in the official decline code list.