Free tools / Stripe decline codes / card_not_supported
Stripe card_not_supported: when the card cannot pay for this purchase
card_not_supported means the card does not support this kind of purchase. On subscriptions it can involve cards with built-in limits on how they are used, such as some prepaid or debit cards that cannot pay for recurring online services. Retrying will not change what the card can do.
- Decline code
- card_not_supported
- Type
- Check your side
- Who can fix it
- The customer — needs to act
- Will a retry help?
- No: do not retry
What it means
The card does not support this kind of purchase (e.g. a prepaid or debit card that cannot be used for recurring online payments).
Check the amount, the currency, the card types you accept and your Stripe or Radar setup before retrying. Depending on the code, the customer may also need another card.
Why it happens
- A prepaid or gift card that does not allow recurring or online payments.
- A debit card the issuer has not enabled for this type of purchase.
- A card type your own settings may not accept, which is worth ruling out on your side.
What to do
- Check your side first: the payment methods and card types enabled on your Stripe account and checkout.
- Do not retry the same card: it cannot make this kind of payment.
- Email the customer that their bank reports the card does not support this payment, with a link to pay with another card.
- If they used a prepaid or gift card, suggest a standard credit or debit card.
- If the customer insists the card should work, they need to ask their bank whether it can be used for recurring online payments.
Should you retry?
No. The card cannot make this type of payment, so a retry fails the same way. Charge again only with a different card, or after the customer's bank confirms the card is enabled.
What to tell the customer
Short and neutral, ready for a checkout error, a billing page or a support reply. No placeholders — ready to paste.
This card cannot be used for this kind of payment. Please pay with another card.
Customer email template
Neutral wording for this situation. Replace {name}, {product}, {link} and {company}.
Hi {name},
The card on file can't be used for the payment for {product}: your bank reported that it does not support this payment. You can check with your bank, or pay with another card here: {link}
Thanks,
{company}Handling many failed payments? See how FlowMRR helps you prioritize failed Stripe payments by revenue at risk. Want a ranked list from your own account? Try the free failed payment audit.
Try FlowMRR freeFrequently asked questions
card_not_supported vs currency_not_supported: what is the difference?
card_not_supported is about the type of purchase: the card cannot be used for it at all. currency_not_supported is narrower: the card works, but not in the currency you bill in.
Should I block prepaid cards at signup?
It is a trade-off. Some prepaid cards renew without trouble, others fail at the first renewal. If they keep causing failures, Stripe Radar rules can take the card's funding type into account.
Is card_not_supported my fault?
Usually not: it is a limitation of the card. A quick check of the payment methods you have enabled is still worthwhile, especially if several customers hit it at once.
Other Stripe decline codes
- generic_decline
- do_not_honor
- insufficient_funds
- card_declined
- expired_card
- authentication_required
- card_velocity_exceeded
- lost_card
- stolen_card
- fraudulent
- pickup_card
- incorrect_cvc
- incorrect_number
- processing_error
- try_again_later
- transaction_not_allowed
- restricted_card
- withdrawal_count_limit_exceeded
- currency_not_supported
- invalid_account
- stop_payment_order
- Look up any decline code
- The complete list of decline codes