Skip to content

Free tools / Card Decline / Complete list

Stripe decline codes: the complete list

Every card decline code Stripe returns, in one table: what it means, whether it is a soft or a hard decline, whether retrying the same card can succeed, who can fix it (the bank, the customer or you), and what to tell the customer. Written for SaaS teams recovering failed subscription payments, not just for developers reading an error.

The list is grouped by what to do about the code rather than alphabetically, because that is the question a failed invoice raises. Each code has a short meaning here; the most common ones have a full guide. The whole table is downloadable as JSON, CSV or Excel, and the same data runs the lookup tool and an open-source npm package.

Abderrahim Ben Jazia, PhDBy · Founder of FlowMRR, previously built and sold AIS (Avance Immédiate Services), French tax-credit softwareUpdated:

Checked against Stripe's decline-code reference on 12 November 2026 · 51 codes · 8 categories · 40 hard · 11 soft

Download the list

The same data as this page. JSON holds both languages; CSV and Excel are in the page's language, one row per code with the customer message and the email.

JSONCSVExcel (.xlsx)

MIT licence: use it in your product, your dunning emails or your support macros.

Soft or hard?

Hard. The same card is refused every time until something changes (a new card, a lifted limit or restriction, an authentication), or Stripe and the card networks ask you not to retry it. Retrying a hard decline costs authorization rate and can cost network fees.

Soft. The bank said no without a lasting reason. A later attempt, such as one scheduled by Stripe's Smart Retries, can succeed.

Temporary refusal (10)

The bank said no without a lasting reason. A later retry, such as one scheduled by Stripe's Smart Retries, often succeeds; a gentle reminder helps.

CodeWhat it meansSoft / hardRetry?Who fixes itGuide
generic_declineGeneric declineStripe's most common code: the bank declined without giving a reason, or Stripe itself blocked the payment (Radar, or Adaptive Acceptance on IC+ pricing) before the bank saw it. Check outcome.type and outcome.reason to tell the two apart.SoftLikelyThe bankGuide
do_not_honorDo not honorStripe says only that the bank declined for an unknown reason and that the customer should contact it. In practice it is the bank's opaque 'no' (a temporary lock, a spending rule, a risk score on their side), and a later retry can succeed.SoftLikelyThe bankGuide
card_declinedCard declined (error code)Not a decline code: Stripe's error code for any card decline. The reason is in decline_code; when that is empty, treat it like a generic decline.SoftMaybeThe bankGuide
try_again_laterTry again laterDeclined for a reason the issuer did not give; Stripe's advice is to retry later and, if it keeps failing, have the customer contact their bank. Stripe lists this code as deprecated, so you mostly see it on older payments.SoftLikelyThe bankGuide
processing_errorProcessing errorA transient error while the payment was being processed, usually on the issuer or network side.SoftLikelyThe bankGuide
issuer_not_availableIssuer not availableThe customer's bank could not be reached to authorize the payment.SoftLikelyThe bankDetails
reenter_transactionRe-enter transactionThe issuer could not process the payment and asks for it to be submitted again.SoftLikelyThe bankDetails
approve_with_idApprove with IDThe payment could not be authorized without identification; for online payments this is effectively a transient decline.SoftLikelyThe bankDetails
call_issuerCall issuerStripe gives no reason and says the customer should contact their bank. The network response behind it asks the cardholder to call the bank before the payment can go through, often for a check on the bank's side.SoftMaybeThe customerDetails
no_action_takenNo action takenStripe gives no reason and says the customer should contact their bank; the network response means the bank did not process the request.SoftMaybeThe bankDetails

Insufficient funds (1)

The balance or available credit did not cover the charge at that moment. A retry a few days later often succeeds once the account is topped up.

CodeWhat it meansSoft / hardRetry?Who fixes itGuide
insufficient_fundsInsufficient fundsThe account did not have enough balance or credit at the time of the charge.SoftLikelyThe customerGuide

Limit reached (2)

The charge went over a balance, credit or transaction limit set on the card. The issuer keeps refusing the same card until the customer changes that limit, so do not count on a retry: ask for another card or a higher limit.

CodeWhat it meansSoft / hardRetry?Who fixes itGuide
withdrawal_count_limit_exceededWithdrawal limit exceededThe customer went over the balance or credit limit available on their card.HardNoThe customerGuide
card_velocity_exceededCard limit exceededThe customer went over the balance, credit limit or transaction amount limit available on their card.HardNoThe customerGuide

Card update needed (16)

The card on file is expired, wrong or closed. Retrying will fail every time; only the customer can replace it.

CodeWhat it meansSoft / hardRetry?Who fixes itGuide
expired_cardExpired cardThe card has passed its expiry date. Card networks refresh many cards automatically, but this one was not.HardNoThe customerGuide
incorrect_numberIncorrect numberThe card number is wrong.HardNoThe customerGuide
invalid_numberInvalid numberThe card number is not a valid card number.HardNoThe customerDetails
invalid_accountInvalid accountThe card or the account behind it is invalid or closed.HardNoThe customerGuide
new_account_information_availableNew account information availableThe card was replaced; the issuer has new details (number or expiry).HardNoThe customerDetails
incorrect_cvcIncorrect CVCThe security code did not match.HardNoThe customerGuide
invalid_cvcInvalid CVCThe security code is not valid.HardNoThe customerDetails
invalid_expiry_monthInvalid expiry monthThe expiry month is wrong.HardNoThe customerDetails
invalid_expiry_yearInvalid expiry yearThe expiry year is wrong.HardNoThe customerDetails
incorrect_zipIncorrect ZIPThe postal code did not match the one on file at the bank.HardNoThe customerDetails
incorrect_addressIncorrect addressThe billing address entered does not match the one the bank has on file.HardNoThe customerDetails
incorrect_pinIncorrect PINWrong PIN (card-present payments only).HardNoThe customerDetails
invalid_pinInvalid PINInvalid PIN (card-present payments only).HardNoThe customerDetails
pin_try_exceededPIN tries exceededToo many wrong PIN attempts; the card is locked.HardNoThe customerDetails
offline_pin_requiredOffline PIN requiredThe card requires a PIN entered on a terminal.HardNoThe customerDetails
online_or_offline_pin_requiredPIN requiredThe card requires a PIN to be used.HardNoThe customerDetails

Card not allowed (5)

The card cannot be used for this kind of payment (online, recurring or international), or the bank restricted it. Retrying the same card will not help; the customer has the restriction lifted or uses another card.

CodeWhat it meansSoft / hardRetry?Who fixes itGuide
restricted_cardRestricted cardThe customer cannot use this card for this payment; Stripe notes it may have been reported lost or stolen. Banks also return it for cards restricted to some purchase types (online, recurring, international).HardNoThe customerGuide
transaction_not_allowedTransaction not allowedStripe gives no reason and says the customer should contact their bank. The network response usually means the card is not allowed to make this kind of transaction (online, recurring or international).HardNoThe customerGuide
not_permittedNot permittedThe payment is not permitted on this card or account.HardNoThe customerDetails
service_not_allowedService not allowedStripe gives no reason and says the customer should contact their bank; the network response means the bank does not allow this service for the card.HardNoThe customerDetails
do_not_try_againDo not try againStripe gives no reason and says the customer should contact their bank; the network response asks you not to retry. Stripe lists this code as deprecated, so you mostly see it on older payments.HardNoThe customerDetails

Authentication required (3)

The bank wants the cardholder to confirm the payment (3-D Secure / SCA). Stripe cannot retry headlessly; the customer must complete it from the hosted invoice.

CodeWhat it meansSoft / hardRetry?Who fixes itGuide
authentication_requiredAuthentication requiredThe bank requires 3-D Secure / Strong Customer Authentication for this charge. Common in Europe on the first charge or after a card change.HardNoThe customerGuide
authentication_not_handledAuthentication not completedRelated to authentication_required: the bank asked for authentication (3-D Secure / SCA), the payment went ahead without it, and the bank declined again.HardNoThe customerDetails
mobile_device_authentication_requiredMobile device authentication requiredThe bank wants the customer to authenticate the payment on their phone or watch (in-person payments). Stripe's advice is to have the customer tap their device again.HardNoThe customerDetails

Blocked card (8)

Lost, stolen, flagged or withdrawn. Do not retry: it can hurt your acceptance rate. Ask for a different card, through a neutral message.

CodeWhat it meansSoft / hardRetry?Who fixes itGuide
fraudulentFraudulentStripe flagged the payment as potentially fraudulent. Show the customer a generic decline, not this reason.HardNoThe customerGuide
lost_cardLost cardThe card was reported lost. The customer usually already has a replacement.HardNoThe customerGuide
stolen_cardStolen cardThe card was reported stolen.HardNoThe customerGuide
pickup_cardPickup cardStripe: the customer cannot use this card for this payment, possibly because it was reported lost or stolen. On card networks the response asks for the physical card to be withdrawn.HardNoThe customerGuide
stop_payment_orderStop payment orderStripe gives no reason and says the customer should contact their bank. On card networks this response usually means the cardholder asked their bank to stop payments to you, but Stripe does not confirm it.HardNoThe customerGuide
revocation_of_authorizationRevocation of authorizationStripe gives no reason and says the customer should contact their bank. On card networks this response means the authorization for this recurring payment was revoked, usually by the cardholder, but Stripe does not confirm it.HardNoThe customerDetails
revocation_of_all_authorizationsRevocation of all authorizationsStripe gives no reason and says the customer should contact their bank. On card networks this response means all recurring authorizations on the card were revoked, usually by the cardholder, but Stripe does not confirm it.HardNoThe customerDetails
security_violationSecurity violationStripe gives no reason and says the customer should contact their bank; the network response names a security block on the card.HardNoThe customerDetails

Check your side (6)

Check the amount, the currency, the card types you accept and your Stripe or Radar setup before retrying. Depending on the code, the customer may also need another card.

CodeWhat it meansSoft / hardRetry?Who fixes itGuide
merchant_blacklistMerchant blacklistThe payment matched a block rule in your Stripe Radar settings (blocked card, email or IP).HardNoYouDetails
card_not_supportedCard not supportedThe card does not support this kind of purchase (e.g. a prepaid or debit card that cannot be used for recurring online payments).HardNoThe customerGuide
currency_not_supportedCurrency not supportedThe card cannot be charged in this currency.HardNoThe customerGuide
invalid_amountInvalid amountThe amount is invalid or above what the card allows. Stripe: if the amount looks right, the customer should check with their bank that a purchase of that size is allowed.HardNoYouDetails
duplicate_transactionDuplicate transactionAn identical charge was submitted very recently.HardNoYouDetails
testmode_declineTest mode declineA Stripe test card was used in live mode (or a decline test card in test mode).HardNoYouDetails

Values that are not decline codes

People paste these from a Charge or a Radar review. They explain a blocked payment, not a bank decline, and the right action differs.

highest_risk_level
highest_risk_level is not a decline code: it is Stripe Radar's risk rating, and it means Radar blocked the payment itself before the bank decided. Treat it like a blocked card (do not retry, ask for another card) unless you believe it is a false positive, in which case check your Radar rules.
elevated_risk_level
elevated_risk_level is not a decline code: it is Stripe Radar's risk rating. Radar does not block these payments by default, so a failed payment with this rating was most likely stopped by one of your own Radar rules. Check your block and review rules before retrying or asking the customer for another card.
rule
This payment was blocked by Stripe Radar (outcome.type "blocked"), not declined by the bank. With outcome.reason "rule" it was one of your own Radar rules. Check which rule matched before charging again or asking the customer for another card.
low_probability_of_authorization
low_probability_of_authorization is not a decline code: it is the outcome.reason of a payment Stripe's Adaptive Acceptance blocked (IC+ pricing) because it was unlikely to be authorized, so the bank never saw it. The decline code is a generic_decline. Check the card and the customer's history before trying again; a retry on Stripe's schedule is not blocked.

Have a code, an error message or a webhook?

Paste it in the lookup tool: it finds the decline code inside, shows the verdict and gives you the customer message and the email to send.

Open the lookup tool

In your own code

This list is the open-source npm package stripe-declines (MIT): the data as JSON, a lookup that reads pasted errors and payloads, and a command line. The lookup tool on this site runs on it.

npm install stripe-declines

Package on npmSource on GitHub

Questions about Stripe decline codes

What is the difference between a soft decline and a hard decline?

A soft decline is a refusal without a lasting cause: the bank could not approve the payment at that moment (generic_decline, do_not_honor, insufficient_funds, try_again_later, processing_error). A later attempt can succeed, which is what Stripe's Smart Retries exploit. A hard decline means the same card will be refused every time until something changes: the card is expired, invalid, lost, stolen or restricted, or the bank requires an authentication or asks you not to retry. For a hard decline, ask for another card or the missing action; retrying only lowers your authorization rate.

Where do I find the decline code in Stripe?

On the failed payment in the Stripe Dashboard, under the payment details. In the API it is `last_payment_error.decline_code` on the PaymentIntent, `outcome.reason` on the Charge, and `decline_code` on a card error. `card_declined` is the generic error code, not the reason; the reason is in `decline_code`. Stripe also returns an `advice_code` (`try_again_later`, `do_not_try_again`, `confirm_card_data`) that says what to do with that attempt.

Which Stripe decline codes can be retried?

The soft ones: generic_decline, do_not_honor, try_again_later, processing_error, issuer_not_available, reenter_transaction, approve_with_id, and insufficient_funds a few days later. call_issuer and no_action_taken may succeed once. Every other code in this list is marked as a hard decline: expired or invalid card data, lost, stolen or blocked cards, limits, restrictions, authentication codes and the codes you fix on your own side. When Stripe gives an advice_code with the attempt, follow it over this table.

Can I download the list of Stripe decline codes?

Yes, from the buttons at the top of this page: JSON (both languages, the package's own data file), CSV and Excel (one language, one row per code with the category, the soft or hard status, the retry verdict, who can fix it, the meaning, the action, the customer message and the customer email). The data is MIT-licensed.

How is this list kept up to date?

The data is checked against Stripe's published decline-code reference; the check date is shown above the table. The codes, their categories and the retry verdicts follow the recovery rules FlowMRR applies to real failed invoices, and the open-source package that holds them has tests that fail when a text contradicts a code's verdict. Corrections are welcome on GitHub, with the Stripe documentation that backs them.

Which declined customers should you contact first?

FlowMRR reads your failed payments from Stripe, ranks who to contact first and drafts the recovery email with the right tone for each decline code. You review it and send it yourself.

Try FlowMRR free
Contact us
FlowMRR

Let's talk

A question, a technical issue or an idea for a partnership? Write to the FlowMRR team.