Decline Decoder

Hard Declines Stripe Won't Retry

Stripe's Smart Retries docs list 9 hard decline codes. For these, scheduled retries keep counting, but a payment only goes through after the customer adds a new payment method.

Stripe Smart Retries: hard decline codes

What to do with a hard decline

  1. Stop expecting the retry schedule to fix it.
  2. Email the customer a secure card-update link straight away.
  3. For lost, stolen or pickup codes, don't tell the customer the specific reason.
  4. For authentication_required, bring the customer back to approve the payment.

What Stripe does by default

Stripe's docs say Smart Retries is on by default for new accounts, set to up to 8 retries within 2 weeks, and that you can choose a window from 1 week to 2 months. Source

Questions

What is a hard decline?

A decline where the bank has rejected the payment in a way that retrying the same card won't fix. Stripe's docs say it can't retry these without a new payment method.

How many times should I retry a soft decline?

Stripe's docs recommend at most eight retries for charges that allow them, and warn that extra retries can look like fraud to banks. New accounts default to up to 8 retries within 2 weeks.

What are failed payments costing you?

Turn on JavaScript to use the calculator.

Example values only; use your own from your Stripe dashboard. Open the full calculator.

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