Free tools / Stripe decline codes / card_declined
Stripe card_declined error: how to inspect decline_code and recover MRR
card_declined is Stripe's general error code for a card payment that was refused. On its own it does not explain why. The useful detail is in the decline_code field that usually accompanies it.
- Decline code
- card_declined
- Type
- Temporary refusal
- Who can fix it
- The bank — usually clears with time
- Will a retry help?
- Maybe: retry once, then ask for another card
What it means
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.
Why it happens
- The issuer refused the payment for a reason that may appear in decline_code.
- A lasting reason such as an expired, lost or blocked card.
- A temporary reason such as insufficient funds or an issuer-side refusal.
- No further detail at all when the issuer returns none.
What to do
- Read decline_code on the PaymentIntent's last_payment_error (or outcome.reason on the Charge) to find the real reason.
- Match that code to the right action: wait for a retry, ask for a new card, or ask the customer to authenticate.
- If decline_code is empty, treat it like a generic decline: one spaced retry and a card-update email.
- Record the code per customer so repeated declines are easy to spot.
Should you retry?
It depends on the underlying decline_code: follow the specific code when there is one. With no decline_code, treat it like a generic decline: one spaced retry, then ask the customer for another card. Retrying every card_declined blindly is not a good policy.
What to tell the customer
Short and neutral, ready for a checkout error, a billing page or a support reply. No placeholders — ready to paste.
Your card was declined. Please try again, or use another card. If it keeps failing, your bank can tell you why.
Customer email template
Neutral wording for this situation. Replace {name}, {product}, {link} and {company}.
Hi {name},
Your bank declined our latest payment for {product}. This can be temporary, and we may try again automatically over the next few days. If it keeps failing, your bank can tell you why. You can also update or confirm your card here: {link}
Thanks,
{company}Handling many failed payments? See how FlowMRR helps you prioritize failed Stripe payments by revenue at risk. Want a ranked list from your own account? Try the free failed payment audit.
Try FlowMRR freeFrequently asked questions
Where do I find the decline code in Stripe?
In the payment details in the Stripe Dashboard, or in the API as last_payment_error.decline_code on the PaymentIntent (or outcome.reason on the Charge).
Is card_declined the same as generic_decline?
No. card_declined is the broad error; generic_decline is one specific decline reason that can appear within it.
Other Stripe decline codes
- generic_decline
- do_not_honor
- insufficient_funds
- expired_card
- authentication_required
- card_velocity_exceeded
- lost_card
- stolen_card
- fraudulent
- pickup_card
- incorrect_cvc
- incorrect_number
- processing_error
- try_again_later
- transaction_not_allowed
- restricted_card
- withdrawal_count_limit_exceeded
- card_not_supported
- currency_not_supported
- invalid_account
- stop_payment_order
- Look up any decline code
- The complete list of decline codes