stolen_cardThe card was reported stolen
Stripe's stolen_card decline means the card was reported stolen. It's a hard decline and Stripe says not to reveal it. Generic wording to use.
- Next step
- Don't tell the customer the reason
- Hard decline
- Yes, on Stripe's list
- Share the reason
- No, use generic wording
What does stolen_card mean?
The payment was declined because the card is reported stolen.
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 and ask for a different payment method. Don't mention theft.
Your card was declined. Please try a different card, or contact your bank for more details.
Should you retry stolen_card?
No. Stripe lists this code as a hard decline. Stripe Billing won't retry the invoice on its own: scheduled retries stay on the invoice, but they only run after the customer adds a new payment method.
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 stolen_card 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 4000000000009979 returns card_declined with decline_code stolen_card.
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 stolen_card, and follow up from there.