merchant_blacklist
The payment matched an entry on your own Stripe block list.
| Group | Fraud, lost or stolen |
|---|---|
| Retry | Retry possible, often needs the customer |
| Customer-facing | Show 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
- Don't tell the customer the specific reason (the docs say to show it as a generic decline).
- Review the payment for fraud before asking for a new card.
- If the customer is genuine, a new card through a secure update link resolves it.
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.