currency_not_supportedmediumAffects MRR

Stripe currency_not_supported Error — Causes, Fix & MRR Impact

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.

What this means

The customer's card cannot be used for this currency. They need to use a card that supports your billing currency or you need to charge in a currency the card supports.

Why it happens

Card limited to certain currencies

The card product only allows charges in specific currencies (e.g. domestic only).

Charge currency mismatch

You charged in a currency (e.g. GBP) that the issuer does not support for this card.

International not enabled

The card is not enabled for international or multi-currency use.

Issuer currency policy

The issuer restricts which currencies can be charged to the card.

MRR Impact

Failed charges due to currency reduce MRR; multi-currency support or clear currency/card guidance improves recovery.

Currency mismatches are fixed by currency options or card update; no retry benefit.

Avg. recovery rate: Good when customer can switch currency or card; retries do not help.

Urgency: within 24h

How to fix it

  1. 1

    Do not retry same card and currency

    When decline_code is currency_not_supported, do not retry. The card will not accept this currency.

  2. 2

    Show clear message

    Tell the customer their card does not support the charge currency. Ask them to use a card that supports this currency or to contact their bank.

  3. 3

    Offer currency choice if supported

    If your product supports multiple currencies, let the customer switch billing currency and retry, or add a card that supports the current currency.

  4. 4

    Document supported currencies

    On pricing or billing pages, list which currencies you charge in so customers can choose a compatible card upfront.

  5. 5

    Log and analyze

    Track currency_not_supported by currency and country; use to decide which currencies to add or how to guide customers.

Detect currency_not_supported automatically

Track currency_not_supported by currency; consider adding or promoting supported currencies.

Monitor your Stripe health free →

FAQ

What is Stripe currency_not_supported?
currency_not_supported means the card does not support the currency you charged (e.g. you charged in EUR but the card only supports USD). The customer should check with their issuer or use a card that supports the charge currency. For SaaS, ensure you charge in a currency the customer's card supports or offer multiple currencies.
Should I retry currency_not_supported?
No. Retrying the same card in the same currency will keep failing. Fix by charging in a supported currency (if your product allows) or asking the customer to use a different card that supports your currency.
How can I prevent currency_not_supported?
If you support multi-currency, let the customer choose currency or detect country and suggest one. For single-currency, make the billing currency clear at signup so customers use a compatible card.
Does this affect SaaS MRR?
Yes. Failed charges in an unsupported currency reduce MRR. Clear currency options and a simple way to switch card or currency help recovery.

Related errors

card_not_supported

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.

Affects MRRinvalid_amount

The Stripe invalid_amount error occurs when the payment amount is invalid or exceeds the amount the issuer allows, causing the charge to be declined 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 MRR