card_not_supportedThe card can't be used for this purchase

Stripe's card_not_supported decline means the card doesn't support this type of purchase. The customer should check with their issuer or use another card.

Next step
Customer should contact their bank
Hard decline
Not on Stripe's list
Share the reason
Yes

What does card_not_supported mean?

The card doesn't support this type of purchase.

Stripe's card decline guide gives examples: FSA and HSA cards are often limited to certain kinds of businesses, and some issuers block purchases from other countries.

What Stripe says to do

The customer needs to contact their card issuer to make sure the card can be used for this type of purchase.

What to tell the customer

Tell the customer their card doesn't allow this kind of purchase, and suggest another card or a call to their bank.

Example wording
Your card isn't set up for this type of purchase. Please use a different card, or ask your bank to allow it.

Should you retry card_not_supported?

Stripe doesn't suggest a retry on the same card. It isn't on Stripe's hard decline list, so Stripe Billing retries follow your Smart Retries or custom schedule.

Before any retry, check the charge's outcome.advice_code. try_again_later means the issuer allows a retry, do_not_try_again means don't use the card again for this transaction, and confirm_card_data means some card details need checking.

Where card_not_supported shows up

On a failed PaymentIntent, read last_payment_error.decline_code. On the Charge, the same code is in outcome.reason. Card declines usually come with the error code card_declined and the reason in decline_code.

Get failed payments in Slack

ChargeBell posts a Slack alert when a Stripe payment fails, with the amount, the customer, and Stripe's decline message. Open the payment from the alert to see its decline code, such as card_not_supported, and follow up from there.

Related decline codes

All Stripe decline codes