do_not_honorDeclined for an unknown reason

Stripe's do_not_honor decline means the bank refused the payment without saying why. What to check in Stripe, what to tell the customer, and retries.

Next step
Customer should contact their bank
Hard decline
Not on Stripe's list
Share the reason
Yes

What does do_not_honor mean?

The card was declined, and the issuer didn't give Stripe a specific reason.

Stripe's card decline guide singles out do_not_honor and generic declines: look at the payment's other data in Stripe. If the CVC or address checks failed when the card was added, ask the customer to verify both before you charge again.

What Stripe says to do

The customer needs to contact their card issuer for more information.

What to tell the customer

Ask the customer to contact their bank or use another card. Don't guess at a reason.

Example wording
Your bank declined this payment. Please contact your bank to find out why, or pay with a different card.

Should you retry do_not_honor?

Stripe doesn't suggest a retry. Its next step is for the customer to contact their issuer. It isn't on Stripe's hard decline list, so Stripe Billing retries follow your Smart Retries or custom schedule. Check the payment's advice_code before trying again.

Before any retry, check the charge's outcome.advice_code. try_again_later means the issuer allows a retry, do_not_try_again means don't use the card again for this transaction, and confirm_card_data means some card details need checking.

Where do_not_honor shows up

On a failed PaymentIntent, read last_payment_error.decline_code. On the Charge, the same code is in outcome.reason. Card declines usually come with the error code card_declined and the reason in decline_code.

Get failed payments in Slack

ChargeBell posts a Slack alert when a Stripe payment fails, with the amount, the customer, and Stripe's decline message. Open the payment from the alert to see its decline code, such as do_not_honor, and follow up from there.

Related decline codes

All Stripe decline codes