restricted_card
The customer can't use this card for this payment. It may have been reported lost or stolen.
| Group | Fraud, lost or stolen |
|---|---|
| Retry | Retry possible, often needs the customer |
| Customer-facing | Safe to explain |
What it means
The customer can't use this card for this payment. It may have been reported lost or stolen.
What Stripe's docs suggest
The customer should contact their bank for details. Source
Will a retry work?
Not on Stripe's hard-decline list, so retries can run, but the bank gave no reason, so the customer may need to call their bank or use another card. Source
What to tell the customer
A message you could send: “Your card was declined. Please use a different card through this secure link.”
If this hit a subscription renewal
- Don't tell the customer the specific reason (the docs say to show it as a generic decline).
- Review the payment for fraud before asking for a new card.
- If the customer is genuine, a new card through a secure update link resolves it.
Similar card-network reason codes
Banks also return a raw network code. These raw codes have a similar meaning to restricted_card. Stripe doesn't publish a one-to-one mapping, so treat this as our guide, not an official match.
| Network | Raw code | Meaning (our wording) |
|---|---|---|
| Visa | 62 | Restricted card (not valid in this region or country) |
| Mastercard | 62 | Restricted card |
Stripe's network decline code tables
Questions
What does restricted_card mean?
The customer can't use this card for this payment. It may have been reported lost or stolen.
Can I retry a restricted_card decline?
Not on Stripe's hard-decline list, so retries can run, but the bank gave no reason, so the customer may need to call their bank or use another card. Source
What should I tell a customer about restricted_card?
A message you could send: “Your card was declined. Please use a different card through this secure link.”
Related codes
Checked against Stripe's public docs on November 17, 2026. Codes and guidance can change; always confirm in the official decline code list.