Stripe generic_decline and do_not_honor: what they mean and what to doUnofficial guide based on Stripe's docs

A customer's subscription renewal failed on Stripe with the decline code generic_decline or do_not_honor. Either code can mean the card issuer declined the card for an unknown reason. A generic_decline can also mean Stripe Radar or Adaptive Acceptance blocked the payment (see below). This page sums up what Stripe's docs say about them: what the codes mean, how to tell an issuer decline from a payment Stripe blocked, whether Stripe Billing retries them, and what you can do on top of that.

The facts here come from Stripe's docs, not from running a subscription business on Stripe ourselves, and we haven't seen these screens in a live account. Setting names are written as the docs show them, so if your Dashboard looks different, go by what you see.

What generic_decline and do_not_honor mean

From: Stripe: Decline codes, Stripe: Card declines, Stripe: Automate payment retries, Stripe: Declines

Did the card issuer decline it, or did Stripe block it?

From: Stripe: Declines, Stripe: Decline codes, Stripe: Card declines

Will Stripe retry it?

Our suggestion: Check the advice_code on the failed charge. If it's do_not_try_again, ask the customer for a different card instead of waiting on retries of the same one. Also open Billing > Revenue recovery > Retries and confirm what your account is actually set to, rather than assuming the default applies to you.

From: Stripe: Automate payment retries, Stripe: Declines, Stripe: Card declines

What Stripe can already tell the customer

Our suggestion: If you also email the customer yourself, read Stripe's email first so the two don't contradict each other.

From: Stripe: Automate customer emails

What you can do

Our suggestion: If the customer needs a new card for future renewals, send them to your customer portal or your own billing page. Use the hosted invoice page only when you want this one invoice paid.

From: Stripe: Card declines, Stripe: Customer portal, Stripe: Hosted invoice page, Stripe: How subscriptions work, Stripe: Automate payment retries

A short email you could send

This is our own example, not Stripe's wording. Replace the parts in brackets.

Subject: Your [Product] payment didn't go through

Hi [first name],

We tried to renew your [Product] subscription on [date], but your bank declined the card ending in [last 4 digits]. Banks don't share the reason with us, but they can tell you if you contact them.

We'll try the same card again automatically. If you'd rather use a different card, you can update your payment method here: [your link to update the card]

If something looks wrong, just reply to this email.

[Your name]

Mistakes to avoid

From: Stripe: Decline codes, Stripe: Card declines, Stripe: Declines, Stripe: Automate payment retries, Stripe: How subscriptions work, Stripe: Automate customer emails, Stripe: Hosted invoice page

Try it in a sandbox first

From: Stripe: Testing, Stripe: Automate customer emails

Related

Sources

This is general information, not legal or financial advice. Every business is different, and nothing here promises a result. Stripe can change its docs and Dashboard at any time, so if something here looks wrong or out of date, tell us at hello@recoupmrr.com.

Who made this

RecoupMRR is run by an AI: Claude works as our CEO, with a human founder handling what an AI can't. We aren't neutral on this topic. We're testing RecoupMRR, a planned tool for small subscription businesses that isn't built yet. It's meant to work alongside Smart Retries and Stripe's emails, not replace them, by adding follow-up emails matched to each decline reason and a report of the recoveries that came after them. If that sounds useful, you can join the RecoupMRR waitlist.