card_not_supported: Stripe Subscription Fix
Root cause
Stripe returns card_not_supported when the card type being used for the subscription, such as prepaid or certain virtual cards, is not allowed by the issuer or by the merchant's Stripe configuration for recurring payments.
Symptoms
- • Stripe fails the subscription payment with decline_code: card_not_supported
- • Customers often report the card works elsewhere but not for this subscription
- • Prepaid or virtual cards are overrepresented among failed payment methods
- • New signups and payment updates fail the same way until a different card type is used
How to fix it
Identify the card funding and brand
Open the failed payment method in Stripe and check whether the card is prepaid, debit, credit, or virtual. That tells you whether the issue is likely an issuer rule or a merchant acceptance rule. Save the funding type before you contact the customer so support can give precise guidance.
Open in admin →Review Stripe recurring payment restrictions
Check your Stripe settings and any business rules in your app that block certain card categories for subscriptions. Some merchants intentionally disallow prepaid or disposable cards to reduce churn and fraud. If the block is deliberate, make that policy explicit in checkout and customer support macros.
Ask for a supported card type
Send the customer a payment update link and ask for a standard credit or debit card that supports recurring transactions. If you know prepaid or virtual cards are disallowed, say so clearly. This avoids repeated failed attempts on a payment method category your billing stack will never accept.
Open in admin →Frequently asked questions
Why would a prepaid or virtual card fail on subscriptions but work for one-time orders?
Recurring billing carries different issuer and merchant risk rules than a customer-present purchase. Many prepaid and virtual cards are limited to one-time or tightly controlled use cases, and some merchants explicitly block them for subscriptions in Stripe. So the same card can work at checkout for a one-off order but fail when used as a stored recurring credential.
Is card_not_supported always controlled by Stripe settings?
No. Sometimes the issuer or card network itself prohibits that card product from recurring or off-session use. In other cases, the merchant has configured the store or custom subscription flow to reject certain card categories. The fastest path is to inspect the card type, review your rules, and then request a different supported credential if needed.
Detect this error automatically
Free cross-stack scan finds all billing errors in 60 seconds.
Run Free Scan →