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.
authentication_requiredhighest_risk_level(not in Stripe’s card decline code table; it relates to Stripe’s own risk screening)incorrect_numberlost_cardpickup_cardrevocation_of_all_authorizationsrevocation_of_authorizationstolen_cardtransaction_not_allowed
Stripe Smart Retries: hard decline codes
What to do with a hard decline
- Stop expecting the retry schedule to fix it.
- Email the customer a secure card-update link straight away.
- For lost, stolen or pickup codes, don't tell the customer the specific reason.
- 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.
Checked against Stripe's public docs on November 17, 2026. Codes and guidance can change; always confirm in the official decline code list.