← All Stripe decline codes

Stripe decline code

card_not_supported

The card does not support this type of transaction.

Type

Hard decline

Recoverable

Partially recoverable

Frequency

Uncommon

What does card_not_supported mean?

card_not_supported typically appears when a customer tries to use a prepaid gift card, a debit card with online transactions disabled, or a card from a region that blocks your merchant category. The card is real and valid; it just cannot be used for your specific charge.

Recovery strategy

Retry approach

Do not retry the same card. Request an alternative payment method from the customer.

Customer message

Explain that this card type is not supported for subscriptions and ask for a different card.

Best practices

  • Accept multiple payment methods (card, bank debit, wallets) to reduce this failure
  • Test your checkout against edge cases like prepaid and virtual cards
  • Document which card types your plans accept

About hard declines

Permanent issue. The card cannot be charged. Customer must provide a new payment method.

Frequently asked questions

Why does a prepaid card trigger card_not_supported for my subscription?

Many subscription products reject prepaid cards because the balance can run out unpredictably. Your payment processor or your own rules may block them automatically.

How Rebounce handles card_not_supported

Automatic hard decline handling, no code required

Rebounce classifies every failed payment by its Stripe decline code and applies the optimal recovery strategy automatically. For card_not_supported, that means a limited retry window combined with customer outreach. Multi-channel follow-up through email, SMS, WhatsApp, and in-app banners ensures the customer actually sees the message.

Start free trial