Stripe Error: Card Not Supported — What It Means & How to Fix It
The card cannot be used for this type of transaction.
What card_not_supported 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 does not support recurring or card-not-present payments
- Issuer blocks this merchant category
- Prepaid or regional card restrictions
How to fix it
- Ask customer to use a different card type.
- Suggest bank-issued credit/debit card for recurring billing.
- Show accepted payment method guidance in checkout.
Recovery email template
Use this as a starting point when the payment needs customer action.
Subject
Payment update needed for Card Not Supported
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 card_not_supported 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: Hard decline on this payment method. Retries are unlikely to work. RetryKit should trigger payment-method replacement workflows.
Stop losing revenue to failed payments. RetryKit automatically recovers failed Stripe payments. Connect in 5 minutes.
Start with RetryKit