Decline Decoder

merchant_blacklist

The payment matched an entry on your own Stripe block list.

GroupFraud, lost or stolen
RetryRetry possible, often needs the customer
Customer-facingShow as a generic decline

What it means

The payment matched an entry on your own Stripe block list.

What Stripe's docs suggest

Don't share the detailed reason with the customer. Show it the same way as a generic decline. Source

Will a retry work?

Not on Stripe's hard-decline list, so retries can run, but the bank gave no reason, so the customer may need to call their bank or use another card. Source

What to tell the customer

Don't reveal the specific reason; Stripe's docs say to present it like a generic decline. A message you could send: “Your card was declined. Please use a different card through this secure link.”

If this hit a subscription renewal

What are failed payments costing you?

Turn on JavaScript to use the calculator.

Example values only; use your own from your Stripe dashboard. Open the full calculator.

Questions

What does merchant_blacklist mean?

The payment matched an entry on your own Stripe block list.

Can I retry a merchant_blacklist decline?

Not on Stripe's hard-decline list, so retries can run, but the bank gave no reason, so the customer may need to call their bank or use another card. Source

What should I tell a customer about merchant_blacklist?

Don't reveal the specific reason; Stripe's docs say to present it like a generic decline. A message you could send: “Your card was declined. Please use a different card through this secure link.”

Related codes

Checked against Stripe's public docs on November 17, 2026. Codes and guidance can change; always confirm in the official decline code list.