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.

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 stolen_card

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.

Related decline codes

All Stripe decline codes