Error codes
Soft decline
Stripe
card_not_supported
The card does not support this type of purchase.
What does card_not_supported mean?
The card_not_supported decline code indicates that the card itself does not support this specific transaction type. The card may work fine for other purchases, but the issuer has configured the card so that this particular kind of transaction is blocked.
Is it a soft or hard decline?
card_not_supported is classified as a soft decline, but recovery usually requires either a different payment method or direct customer action — not a simple retry.
Common root causes
Card not enabled for international purchases
Debit card not authorized for recurring or subscription transactions
Prepaid card with merchant category restrictions
Corporate card blocked for personal purchase categories
Card type unable to support certain authorization types (e.g., $0 authorization)
Recommended recovery steps
Do not retry the same card repeatedly. The restriction is persistent for this card type.
Try a backup payment method on file if available.
Route the customer to update their payment method with clear messaging that their card does not support this transaction type.
Consider alternate payment methods (ACH, BNPL, wallets) if your business supports them.
How FlyCode handles card_not_supported
FlyCode automatically attempts backup payment methods stored on file before escalating to customer outreach. For subscriptions with only one payment method available, FlyCode routes customers to a streamlined update flow with clear messaging explaining that their card cannot be used for recurring charges. This prevents the confusion that causes customers to cancel rather than update.
What does card_not_supported mean?
The card_not_supported decline code indicates that the card itself does not support this specific transaction type. The card may work fine for other purchases, but the issuer has configured the card so that this particular kind of transaction is blocked.
Is it a soft or hard decline?
card_not_supported is classified as a soft decline, but recovery usually requires either a different payment method or direct customer action — not a simple retry.
Common root causes
Card not enabled for international purchases
Debit card not authorized for recurring or subscription transactions
Prepaid card with merchant category restrictions
Corporate card blocked for personal purchase categories
Card type unable to support certain authorization types (e.g., $0 authorization)
Recommended recovery steps
Do not retry the same card repeatedly. The restriction is persistent for this card type.
Try a backup payment method on file if available.
Route the customer to update their payment method with clear messaging that their card does not support this transaction type.
Consider alternate payment methods (ACH, BNPL, wallets) if your business supports them.
How FlyCode handles card_not_supported
FlyCode automatically attempts backup payment methods stored on file before escalating to customer outreach. For subscriptions with only one payment method available, FlyCode routes customers to a streamlined update flow with clear messaging explaining that their card cannot be used for recurring charges. This prevents the confusion that causes customers to cancel rather than update.
What does card_not_supported mean?
The card_not_supported decline code indicates that the card itself does not support this specific transaction type. The card may work fine for other purchases, but the issuer has configured the card so that this particular kind of transaction is blocked.
Is it a soft or hard decline?
card_not_supported is classified as a soft decline, but recovery usually requires either a different payment method or direct customer action — not a simple retry.
Common root causes
Card not enabled for international purchases
Debit card not authorized for recurring or subscription transactions
Prepaid card with merchant category restrictions
Corporate card blocked for personal purchase categories
Card type unable to support certain authorization types (e.g., $0 authorization)
Recommended recovery steps
Do not retry the same card repeatedly. The restriction is persistent for this card type.
Try a backup payment method on file if available.
Route the customer to update their payment method with clear messaging that their card does not support this transaction type.
Consider alternate payment methods (ACH, BNPL, wallets) if your business supports them.
How FlyCode handles card_not_supported
FlyCode automatically attempts backup payment methods stored on file before escalating to customer outreach. For subscriptions with only one payment method available, FlyCode routes customers to a streamlined update flow with clear messaging explaining that their card cannot be used for recurring charges. This prevents the confusion that causes customers to cancel rather than update.
Understanding This Decline Code
Extended content body
Frequently Asked Questions
What does card_not_supported mean?
Should I retry card_not_supported?
No — the card-level restriction is persistent, not temporary. Retries will continue to fail. Recovery requires either a backup payment method or the customer providing a different card.
Can FlyCode recover card_not_supported?
For card_not_supported, FlyCode routes customers to backup payment methods on file and orchestrates alternate payment channels to keep the subscription active without requiring the customer to add a new card manually.
