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.
Your card was declined. Please try a different card, or contact your bank for more details.
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.