Error codes
Soft decline
Stripe
currency_not_supported
The card does not support the specified currency.
What does currency_not_supported mean?
The currency_not_supported decline code is returned when the card does not permit transactions in the specific currency the merchant is charging. The card itself may work fine in its native currency — the restriction is specific to the currency mismatch between the merchant and the card's supported list.
Is it a soft or hard decline?
Classified as a soft decline, but recovery requires either charging in a different currency or using an alternate payment method. Retrying in the same currency will continue to fail.
Common root causes
Debit or prepaid cards with single-currency restrictions
Regional cards not enabled for international currencies
Corporate cards restricted to specific billing currencies
Country-specific cards (e.g., India or Brazil-only cards) that reject USD or EUR charges
Recommended recovery steps
Do not retry in the same currency. The restriction is persistent.
Offer alternate payment methods if available — some cards, BNPL, or wallets may work where the original card fails.
Consider presenting prices in the customer's local currency if your business supports multiple billing currencies.
Route the customer to update their payment method with context about currency support.
How FlyCode handles currency_not_supported
FlyCode detects currency_not_supported declines and immediately attempts backup payment methods stored on file. For subscriptions without backup methods, FlyCode routes customers to update flows with clear messaging about the currency mismatch — reducing confusion and preventing subscription cancellation.
What does currency_not_supported mean?
The currency_not_supported decline code is returned when the card does not permit transactions in the specific currency the merchant is charging. The card itself may work fine in its native currency — the restriction is specific to the currency mismatch between the merchant and the card's supported list.
Is it a soft or hard decline?
Classified as a soft decline, but recovery requires either charging in a different currency or using an alternate payment method. Retrying in the same currency will continue to fail.
Common root causes
Debit or prepaid cards with single-currency restrictions
Regional cards not enabled for international currencies
Corporate cards restricted to specific billing currencies
Country-specific cards (e.g., India or Brazil-only cards) that reject USD or EUR charges
Recommended recovery steps
Do not retry in the same currency. The restriction is persistent.
Offer alternate payment methods if available — some cards, BNPL, or wallets may work where the original card fails.
Consider presenting prices in the customer's local currency if your business supports multiple billing currencies.
Route the customer to update their payment method with context about currency support.
How FlyCode handles currency_not_supported
FlyCode detects currency_not_supported declines and immediately attempts backup payment methods stored on file. For subscriptions without backup methods, FlyCode routes customers to update flows with clear messaging about the currency mismatch — reducing confusion and preventing subscription cancellation.
What does currency_not_supported mean?
The currency_not_supported decline code is returned when the card does not permit transactions in the specific currency the merchant is charging. The card itself may work fine in its native currency — the restriction is specific to the currency mismatch between the merchant and the card's supported list.
Is it a soft or hard decline?
Classified as a soft decline, but recovery requires either charging in a different currency or using an alternate payment method. Retrying in the same currency will continue to fail.
Common root causes
Debit or prepaid cards with single-currency restrictions
Regional cards not enabled for international currencies
Corporate cards restricted to specific billing currencies
Country-specific cards (e.g., India or Brazil-only cards) that reject USD or EUR charges
Recommended recovery steps
Do not retry in the same currency. The restriction is persistent.
Offer alternate payment methods if available — some cards, BNPL, or wallets may work where the original card fails.
Consider presenting prices in the customer's local currency if your business supports multiple billing currencies.
Route the customer to update their payment method with context about currency support.
How FlyCode handles currency_not_supported
FlyCode detects currency_not_supported declines and immediately attempts backup payment methods stored on file. For subscriptions without backup methods, FlyCode routes customers to update flows with clear messaging about the currency mismatch — reducing confusion and preventing subscription cancellation.
Understanding This Decline Code
Extended content body
Frequently Asked Questions
What does currency_not_supported mean?
Can retries fix currency_not_supported?
No — the currency restriction on the card is persistent, not temporary. Recovery requires either a different payment method or charging in a currency the card supports.
How does FlyCode handle currency_not_supported?
FlyCode helps merchants orchestrate payment methods across currencies, routing customers to backup methods or alternate billing currencies when their primary card cannot be charged in the merchant's currency.
