generic_declineDeclined for an unknown reason, or blocked

Stripe's generic_decline means the issuer declined without a reason, or Radar or Adaptive Acceptance blocked the payment. How to tell which and what to say.

Next step
Customer should contact their bank
Hard decline
Not on Stripe's list
Share the reason
Yes

What does generic_decline mean?

The card was declined for an unknown reason, or Stripe Radar or Adaptive Acceptance blocked the payment before it reached the bank.

Stripe says issuers label most declines as generic, so this is the code you'll see most.

To tell an issuer decline from a Stripe block, look at the charge's outcome.type: issuer_declined means the bank said no, blocked means Stripe stopped it. If a Radar rule blocked a payment you recognize as legitimate, you can add it to an allow list in the Dashboard. That doesn't retry the payment.

Stripe also tells you to present fraudulent, lost_card, stolen_card, and merchant_blacklist to customers as generic_decline.

What Stripe says to do

The customer needs to contact their card issuer for more information.

What to tell the customer

Tell the customer the card was declined and ask them to contact their bank or use another card. This is also the wording Stripe says to use for the codes you shouldn't reveal.

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 generic_decline

Should you retry generic_decline?

Stripe doesn't suggest a retry. Its next step is for the customer to contact their issuer. It isn't on Stripe's hard decline list, so Stripe Billing retries follow your Smart Retries or custom schedule. Check the advice_code first.

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 generic_decline 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.

To test it in a Stripe sandbox: Stripe's test card 4000000000000002 returns card_declined with decline_code generic_decline.

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

Related decline codes

All Stripe decline codes