Stripe Error: card_not_supported
The card does not support the type of purchase being made.
What This Means
A card_not_supported decline means the customer's card cannot process the specific type of transaction you're attempting. This could be a card that doesn't support recurring payments, international transactions, or e-commerce purchases. Some prepaid cards, corporate cards with restrictions, and certain regional card types fall into this category. It's not a problem with the customer's balance or the card's validity — it's a fundamental incompatibility between the card and your charge type.
Why This Happens
- The card is a prepaid or gift card that doesn't support recurring or subscription charges
- The card has restrictions on international or cross-border transactions
- Corporate or purchasing cards may be limited to specific merchant categories
- Some card types (like certain debit cards in specific countries) don't support card-not-present transactions
How To Fix It
- 1Ask the customer to use a different card that supports online recurring payments
- 2If you serve international customers, ensure your Stripe account supports their card's currency
- 3Provide clear messaging at checkout about which card types are accepted
- 4Consider adding alternative payment methods like bank transfers or digital wallets for customers in regions with card limitations
The Automated Solution
Revive detects card_not_supported declines and sends the customer a helpful email explaining that their current card can't process this type of payment, along with a link to update to a compatible card. No wasted retries, no confusion — just a clear path to resolution.
Revive connects to your Stripe account in 60 seconds. It monitors every failed charge, applies the right recovery strategy for each decline code, and sends branded emails to your customers when human action is needed. No code changes. No configuration. Just recovered revenue.
Connect Stripe & Start RecoveringRelated Stripe Errors
card_declinedThe customer's card was declined by their bank with no specific reason given.
currency_not_supportedThe card does not support transactions in the requested currency.
do_not_honorThe customer's bank has declined the transaction without giving a specific reason.
generic_declineThe card was declined for an unspecified reason.
Frequently Asked Questions
Is card_not_supported the customer's fault?
Not really. The customer may not know their card has restrictions. It's best to communicate the issue without blame and help them switch to a compatible payment method.
Can I prevent card_not_supported errors at checkout?
Partially. Using Stripe Elements, you can detect some unsupported card types before the charge is attempted. Stripe also provides card brand and funding type (credit, debit, prepaid) in the API response, which you can use to filter.
Should I retry a card_not_supported decline?
No. This is a hard decline. The card's limitations won't change. The customer needs to provide a different payment method.
Learn More
Stop fixing payment errors manually
Revive monitors every failed Stripe charge, applies the optimal recovery strategy, and wins back revenue while you sleep. Connect in 60 seconds, recover in hours.
Start Recovering Revenue