fraudulentStripe suspects fraud
Stripe's fraudulent decline means Stripe suspects the payment is fraudulent. Stripe says not to tell the customer. Generic wording to use instead.
- 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 fraudulent mean?
Stripe declined the payment because it suspects fraud.
Stripe doesn't publish retry guidance for this code. Review the payment and customer in Stripe before you accept another attempt.
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 the same wording you'd use for generic_decline. Don't mention fraud.
Your card was declined. Please try a different card, or contact your bank for more details.
Should you retry fraudulent?
Stripe doesn't say. It isn't on Stripe's hard decline list, but review the payment before you accept another attempt.
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 fraudulent 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 token tok_visa_chargeDeclinedFraudulent returns card_declined with decline_code fraudulent.
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 fraudulent, and follow up from there.