Stripe decline code
card_not_supported
The card does not support this type of purchase (for example, certain subscriptions or currencies).
Quick answer
card_not_supported is a hard decline. Retrying will keep failing; the customer has to act.
| Decline code | card_not_supported |
|---|---|
| Type | Hard (needs customer action) |
| Retrying helps? | No |
| Category | Card details |
| Customer fix | Use a different card. |
Will retrying help?
No, retrying will keep failing
Email the customer asking for an alternative card; retries on the same card will not succeed.
A real example
The customer's card type does not support recurring billing or this purchase category, so it is declined.
What the customer needs to do
Use a different card.
Your recovery approach
Email the customer asking for an alternative card; retries on the same card will not succeed.
Copy-paste recovery email
Subject
Your payment didn't go through, [First Name]
A detail on your saved card did not match, so the charge for [Product] was declined.
Re-enter your card details and we will retry right away.
Recover card_not_supported declines on autopilot
SubRevival reads every decline code and responds correctly, retrying soft declines on smart timing and emailing customers for hard ones, with a hosted card update page. $19/mo flat.
FAQ
What does the Stripe "card_not_supported" decline code mean?
The card does not support this type of purchase (for example, certain subscriptions or currencies).
Will retrying a "card_not_supported" decline work?
No. card_not_supported is a hard decline, so retrying the same card will keep failing. Email the customer asking for an alternative card; retries on the same card will not succeed.
How do I recover a payment that failed with "card_not_supported"?
Email the customer asking for an alternative card; retries on the same card will not succeed. Customer action: Use a different card.
Related decline codes
Source: official Stripe decline codes documentation. Recovery guidance is SubRevival's own.