Stripe card_declined: what it means and how to find the real reason

What it means

Stripe's umbrella error code. The real reason is in `decline_code`; when that is empty, treat it like a generic decline.

The bank said no without a lasting reason. Stripe's Smart Retries recover a large share of these within a few days; a gentle reminder helps.

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 failure_code on older Charge objects) 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 entirely on the underlying decline_code. Retrying every card_declined blindly is not a good policy; use the specific code to decide.

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 is usually temporary. We will retry automatically over the next few days, but you can also update or re-confirm your card here: {link}

Thanks,
{company}