Hard decline · recoverable

card_not_supported

The card doesn't support this type of purchase.

What just happened

Card type can't be used for this kind of transaction (e.g. a debit card on a recurring international purchase).

Retry strategy

Don't retry — it'll keep failing. Ask for a different card.

What to tell the customer

Your card doesn't support recurring charges. Please add a different payment method to keep your subscription active.

Recommended action

Skip retries, send update-card email immediately with explanation.

Want to see what this looks like on your Stripe?

See how often "card_not_supported" hits your Stripe account in the last 30 days — and how much MRR is at risk because of it.

Run free audit

Related codes

currency_not_supported

The card doesn't support the transaction currency.

do_not_try_again

Issuer explicitly said: don't retry this card.

expired_card

Card's expiration date has passed.

invalid_account

Account number isn't valid at the issuer.

Related guides

Soft Decline vs Hard Decline: What They Mean for Your Revenue

Understand the difference between soft and hard payment declines. Learn how to handle each type to maximize recovery and reduce involuntary churn.

How to Find and Size Failed Payments in Stripe (Step-by-Step)

Find every failed payment in your Stripe account, export it, remove retry duplicates, group by decline code, and calculate your real MRR at risk — step by step.

Stripe Billing Recovery Settings: The Recommended Setup

Every Stripe setting that affects failed payment recovery — retries, customer emails, end-of-retry status, card updates, automations — where it lives in the Dashboard and what to set it to.

Frequently asked questions

Is "card_not_supported" a soft or hard decline?+
It's classified as a hard decline: Permanent issue with the card. Retries will keep failing — you need a new payment method from the customer.
Should I retry a "card_not_supported" decline?+
Don't retry — it'll keep failing. Ask for a different card.
What should I tell my customer when this happens?+
Your card doesn't support recurring charges. Please add a different payment method to keep your subscription active.
How do I prevent this decline going forward?+
Skip retries, send update-card email immediately with explanation.
Does Rechurn handle this decline code automatically?+
Yes. Rechurn classifies "card_not_supported" and runs the optimal retry cadence with a personalized email sequence. Run a free audit to see how many of your failed charges are this code.
All decline codes