Skip to content

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.

Abderrahim Ben Jazia, PhDBy · Founder of FlowMRR, previously built and sold AIS (Avance Immédiate Services), French tax-credit softwareUpdated:
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

  1. Stop retries on this card until the customer tells you the restriction is gone.
  2. Send a neutral email: the bank reported the card cannot be used for this payment, with a link to pay with another card.
  3. Suggest the customer contacts their bank if they want to keep using this card.
  4. Do not guess the reason in your message; only the issuer knows it.
  5. 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 free

Frequently 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.

Contact us
FlowMRR

Let's talk

A question, a technical issue or an idea for a partnership? Write to the FlowMRR team.