Free tools / Stripe decline codes / restricted_card
Stripe restricted_card: recovering payments on a restricted card
restricted_card means the issuer has placed a restriction on the card that stops this payment: a limit on where or how it can be used, or a temporary block. The bank does not say why, and Stripe notes it can even follow a card reported lost or stolen, so treat the card as unusable until the customer says otherwise.
- Decline code
- restricted_card
- Type
- Card not allowed
- Who can fix it
- The customer — needs to act
- Will a retry help?
- No: do not retry
What it means
The customer cannot use this card for this payment; Stripe notes it may have been reported lost or stolen. Banks also return it for cards restricted to some purchase types (online, recurring, international).
The card cannot be used for this kind of payment (online, recurring or international), or the bank restricted it. Retrying the same card will not help; the customer has the restriction lifted or uses another card.
Why it happens
- The bank limited the card to certain uses, for example no online, recurring or international payments.
- A temporary restriction after unusual activity, pending a check with the cardholder.
- An account-level issue on the bank's side that it handles by restricting the card.
- In some cases, a card reported lost or stolen.
What to do
- Stop retries on this card until the customer tells you the restriction is gone.
- Send a neutral email: the bank reported the card cannot be used for this payment, with a link to pay with another card.
- Suggest the customer contacts their bank if they want to keep using this card.
- Do not guess the reason in your message; only the issuer knows it.
- When the customer confirms or adds a new card, collect the open invoice through the link.
Should you retry?
Do not retry as is. The restriction stays until the bank lifts it, so retries only add declines. Charge again once the customer confirms the restriction is lifted, or adds another card.
What to tell the customer
Short and neutral, ready for a checkout error, a billing page or a support reply. No placeholders — ready to paste.
Your bank does not allow this card for this payment. Please contact your bank, or pay with another card.
Customer email template
Neutral wording for this situation. Replace {name}, {product}, {link} and {company}.
Hi {name},
Your bank reported that the card on file can't be used for this payment for {product}. You can ask your bank to allow it, or pay with another card here: {link}
Thanks,
{company}Handling many failed payments? See how FlowMRR helps you prioritize failed Stripe payments by revenue at risk. Want a ranked list from your own account? Try the free failed payment audit.
Try FlowMRR freeFrequently asked questions
restricted_card vs transaction_not_allowed: which applies?
Both stop the payment because of a rule on the card. transaction_not_allowed points to the type of transaction (online, recurring, foreign); restricted_card is a restriction on the card more generally. The recovery is the same: the customer contacts their bank or uses another card.
Is restricted_card permanent?
Not necessarily. Some restrictions are lifted once the cardholder speaks to the bank; others, such as a card reported lost or stolen, are final. You cannot tell from Stripe, so ask the customer.
Should my email mention the restriction?
Briefly and neutrally: the bank reports that the card cannot be used for this payment. Avoid guessing about fraud, debt or theft.
Other Stripe decline codes
- generic_decline
- do_not_honor
- insufficient_funds
- card_declined
- expired_card
- authentication_required
- card_velocity_exceeded
- lost_card
- stolen_card
- fraudulent
- pickup_card
- incorrect_cvc
- incorrect_number
- processing_error
- try_again_later
- transaction_not_allowed
- withdrawal_count_limit_exceeded
- card_not_supported
- currency_not_supported
- invalid_account
- stop_payment_order
- Look up any decline code
- The complete list of decline codes