Free tools / Stripe decline codes / do_not_honor
Stripe do_not_honor code: retry rules and SaaS recovery
do_not_honor is a Stripe decline_code returned on failed subscription invoices and PaymentIntents when the issuing bank refuses a charge without a specific reason. For SaaS merchants, banks use it as a catch-all response for velocity limits, risk checks or temporary holds.
- Decline code
- do_not_honor
- Type
- Temporary refusal
- Who can fix it
- The bank — usually clears with time
- Will a retry help?
- Likely: let Smart Retries run
What it means
Stripe says only that the bank declined for an unknown reason and that the customer should contact it. In practice it is the bank's opaque 'no' (a temporary lock, a spending rule, a risk score on their side), and a later retry can succeed.
The bank said no without a lasting reason. A later retry, such as one scheduled by Stripe's Smart Retries, often succeeds; a gentle reminder helps.
Why it happens
- A temporary hold, spending limit or velocity rule on the customer's account.
- A risk or fraud score on the bank's side at the moment of the charge.
- A card or account restriction the bank does not disclose.
- A transient issuer-side refusal that clears on a later attempt.
What to do
- Wait for a retry on Stripe's schedule, or retry manually after a few days, rather than immediately.
- Send the customer a neutral email with a card-update link.
- If it fails again, ask them to contact their bank: only the issuer can say why.
- If the bank confirms it released the hold, retry the payment.
- If it keeps failing, request a different card.
Should you retry?
A later retry can succeed when the cause was temporary, but two failures in a row usually mean the customer needs to speak to their bank or switch cards.
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 bank declined this payment. This is often temporary: please try again later, or use another card. If it fails again, 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 freeFrequently asked questions
Why does the bank say do_not_honor without a reason?
Issuers use it as a general-purpose refusal and card networks do not require them to explain. Stripe passes the code along but cannot see the underlying reason.
Is do_not_honor a fraud signal?
Not necessarily. It can come from fraud checks, but it also covers limits and temporary holds. Treat it as unexplained rather than as proof of fraud.
Other Stripe decline codes
- generic_decline
- insufficient_funds
- card_declined
- expired_card
- authentication_required
- card_velocity_exceeded
- lost_card
- stolen_card
- fraudulent
- pickup_card
- incorrect_cvc
- incorrect_number
- processing_error
- try_again_later
- transaction_not_allowed
- restricted_card
- withdrawal_count_limit_exceeded
- card_not_supported
- currency_not_supported
- invalid_account
- stop_payment_order
- Look up any decline code
- The complete list of decline codes