merchant_blacklistThe payment matches your block list

Stripe's merchant_blacklist decline means the payment matched a value on your own Stripe block list. Stripe says not to tell the customer. What to do.

Next step
Don't tell the customer the reason
Hard decline
Not on Stripe's list
Share the reason
No, use generic wording

What does merchant_blacklist mean?

The payment matches a value on your Stripe account's block list.

The block comes from your own account, not the customer's bank. Check the block list entry in Stripe, and remove it if it was added by mistake.

What Stripe says to do

Don't give the customer more detail. Present it the same way as generic_decline.

What to tell the customer

Stripe says not to share this reason with the customer.

Use generic wording. Don't mention a block list.

Example wording
Your card was declined. Please try a different card, or contact your bank for more details.

Draft a full failed payment email for merchant_blacklist

Should you retry merchant_blacklist?

Stripe doesn't say. The decline comes from your own block list, so check that entry before you decide.

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 merchant_blacklist 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 merchant_blacklist, and follow up from there.

Related decline codes

All Stripe decline codes