restricted_cardThe card can't be used for this payment
Stripe's restricted_card decline means the card can't be used for this payment, possibly after a lost or stolen report. What to tell the customer.
- Next step
- Customer should contact their bank
- Hard decline
- Not on Stripe's list
- Share the reason
- Yes
What does restricted_card mean?
The customer can't use this card for this payment. It may have been reported lost or stolen.
Stripe describes restricted_card the same way as pickup_card, but only pickup_card is on Stripe Billing's hard decline list.
What Stripe says to do
The customer needs to contact their card issuer for more information.
What to tell the customer
Ask the customer to contact their bank or use another card. Keep the wording neutral.
Your bank declined this payment. Please contact your bank to find out why, or pay with a different card.
Should you retry restricted_card?
Stripe doesn't suggest a retry. It isn't on Stripe's hard decline list, so Stripe Billing retries follow your Smart Retries or custom schedule.
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 restricted_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.
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 restricted_card, and follow up from there.