card_not_supportedmediumAffects MRR

Stripe card_not_supported Error — Causes, Fix & MRR Impact

The Stripe card_not_supported error occurs when the card does not support the type of purchase (e.g. recurring or international), causing the charge to be declined and MRR risk for SaaS businesses processing subscription payments.

What this means

This card cannot be used for this kind of purchase. The customer should try another card or payment method, or check with their bank.

Why it happens

Card product limits

The card product (e.g. certain prepaid or gift cards) does not allow recurring or online payments.

Issuer or network rules

The issuer or network restricts this card for subscription or merchant category.

International or currency

The card may not be enabled for international or the currency you charge.

Merchant category code

The card is restricted for your business's merchant category (e.g. digital goods, SaaS).

MRR Impact

Recovery depends on the customer using another card or method; a clear update flow protects MRR.

Card product limits are common; offering alternatives and a clear update path protects MRR.

Avg. recovery rate: Good when you make it easy to add another card or switch payment method.

Urgency: within 24h

How to fix it

  1. 1

    Detect and do not retry same card

    When decline_code is card_not_supported, do not retry the same PaymentMethod. Treat as 'use another method'.

  2. 2

    Prompt for another card or method

    Show a message like 'This card cannot be used for this purchase. Please add a different card or choose another payment method.' Link to add card or select method.

  3. 3

    Offer alternative payment methods

    If you support ACH, bank transfer, or other methods, surface them so the customer can complete the subscription without relying on that card.

  4. 4

    Send dunning with update link

    Email the customer that the payment could not be completed and that their card may not support this type of purchase; include a link to update payment method.

  5. 5

    Log for product insights

    Track card_not_supported by card brand or BIN if available; use to inform which payment methods to promote or support.

Detect card_not_supported automatically

Track card_not_supported rate; consider promoting alternative payment methods in onboarding or billing.

Monitor your Stripe health free →

FAQ

What does Stripe card_not_supported mean?
card_not_supported means the card does not support this type of purchase (e.g. some cards cannot be used for recurring or international payments). The customer should contact their card issuer to confirm their card can be used for this purchase type, or use a different card or payment method in your app.
Should I retry card_not_supported?
Retrying the same card usually will not help. The limitation is with the card product. Prompt the customer to use another card or payment method (e.g. different card brand or alternative method like ACH if you support it).
How do I reduce card_not_supported for subscriptions?
Upfront, you can encourage cards that typically support recurring payments. When you get this decline, make it easy to add another card or switch to a supported method. Clear messaging avoids confusion and preserves MRR.
Does card_not_supported affect MRR?
Yes. Without a simple path to add another card or payment method, the customer may churn. Offering multiple payment options and a clear update flow helps recover MRR.

Related errors

currency_not_supported

The Stripe currency_not_supported error occurs when the card does not support the currency in which the charge was made, causing the decline and MRR risk for SaaS businesses processing subscription payments.

Affects MRRtransaction_not_allowed

The Stripe transaction_not_allowed error occurs when the card issuer does not allow the transaction (e.g. type or context), causing the decline and MRR risk for SaaS businesses processing subscription payments.

Affects MRRnot_permitted

The Stripe not_permitted error occurs when the issuer does not permit the payment (e.g. transaction type or merchant category), causing the decline and MRR risk for SaaS businesses processing subscription payments.

Affects MRR