Stripe Error: Restricted Card — What It Means & How to Fix It
The card has usage restrictions that prevent this payment.
What restricted_card means in Stripe
The right recovery response depends on whether the decline is temporary, customer-actionable, or unlikely to succeed without a new payment method.
- Decline type
- Hard or customer-action decline
- Retry guidance
- Use the decline type to decide whether to retry automatically, wait for customer action, or stop retrying this payment method.
Common causes
- Card blocked for recurring charges
- Issuer regional or merchant restrictions
- Corporate controls on transaction type
How to fix it
- Ask customer to contact issuer to remove restriction.
- Collect an unrestricted payment method.
- Clarify your descriptor so issuer support can identify charge.
Recovery email template
Use this as a starting point when the payment needs customer action.
Subject
Payment update needed for Restricted Card
Body
Hi {{customer_name}}, we could not process your latest payment. Please review or update your payment method here: {{billing_portal_link}}.
Related Stripe decline-code questions
What does restricted_card mean in Stripe?
It is a Stripe decline code that explains why the issuer or payment network rejected the payment.
Should I retry this failed payment?
Retry only when the decline is likely to recover. Hard declines usually need a new payment method first.
How can RetryKit help?
RetryKit classifies failed invoices, runs timed retries, sends dunning emails, and tracks recovered revenue.
Should you retry this Stripe error?
Hard decline: Mostly hard decline until restrictions are changed. RetryKit should prefer payment method update over repeated retries.
Stop losing revenue to failed payments. RetryKit automatically recovers failed Stripe payments. Connect in 5 minutes.
Start with RetryKit