Free tools / Stripe decline codes / merchant_blacklist
Stripe decline code: merchant_blacklist
merchant_blacklist is one of the decline codes Stripe returns when a card payment fails, in last_payment_error.decline_code on the PaymentIntent or outcome.reason on the Charge. Stripe's label for it is "Merchant blacklist". Here is what it means, whether a retry can succeed, who can fix it, and what to tell the customer.
- Decline code
- merchant_blacklist
- Type
- Check your side
- Who can fix it
- You — something on your side
- Will a retry help?
- No: do not retry
What it means
The payment matched a block rule in your Stripe Radar settings (blocked card, email or IP).
Check your side. Check the amount, the currency, the card types you accept and your Stripe or Radar setup before retrying. Depending on the code, the customer may also need another card.
Should you retry?
No: do not retry. No. The bank will refuse the same card as is, or Stripe or the network asked not to try again. Retrying wastes an attempt and can breach the card networks' reattempt rules. Change what is wrong, or ask for another card.
Recommended action
Who can fix it: You — something on your side. Review your Radar block lists before charging again. Nothing the customer can do; if you contact them, present it as a generic decline.
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.
This payment was declined. Please pay with another card, or contact us.
Customer email template
Neutral wording for this situation. Replace {name}, {product}, {link} and {company}.
Hi {name},
Our payment attempt for {product} did not go through. We are checking the payment details and will let you know if anything is needed from you.
Thanks,
{company}Stripe's documentation
Stripe lists this code, with its advice for the customer, in its decline codes reference. The data on this page was last checked against it on 12 November 2026.
Related decline codes
Codes that behave the same way, to read next.
Handling many failed payments? See how FlowMRR helps you prioritize failed Stripe payments by revenue at risk.
Try FlowMRR free