Skip to content

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.

Abderrahim Ben Jazia, PhDBy · Founder of FlowMRR, previously built and sold AIS (Avance Immédiate Services), French tax-credit softwareUpdated:
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

  1. Read decline_code on the PaymentIntent's last_payment_error (or outcome.reason on the Charge) to find the real reason.
  2. Match that code to the right action: wait for a retry, ask for a new card, or ask the customer to authenticate.
  3. If decline_code is empty, treat it like a generic decline: one spaced retry and a card-update email.
  4. 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 free

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

Contact us
FlowMRR

Let's talk

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