currency_not_supported: Stripe Subscription Fix
Root cause
Stripe returns currency_not_supported when the customer's card or issuing bank does not allow charges in the subscription's billing currency, which is especially common for international subscribers paying outside their card's supported settlement currencies.
Symptoms
- • International subscribers fail while domestic subscribers in the same store bill normally
- • Stripe shows decline_code: currency_not_supported on the invoice or charge
- • Changing retry timing does not improve recovery because the currency itself is the problem
- • Customers often say the same card works in local-currency purchases but not this subscription
How to fix it
Confirm the billing currency in Stripe
Review the failed invoice or charge in Stripe Dashboard and note the presentment currency used for the subscription. This verifies that the issue is tied to currency compatibility rather than funds or fraud screening. Compare it against the subscriber's country and card issuer region if you have that data.
Open in admin →Offer a supported local currency path
If your catalog supports it, move the subscriber to a plan billed in a currency their issuer accepts. Many merchants solve this by duplicating subscription plans in region-specific currencies. Make sure the customer understands that the plan price may differ after currency conversion and taxes.
Request another internationally enabled card
If you cannot change the subscription currency, ask the customer for a card that supports foreign or multi-currency recurring charges. This is common with domestic debit products that block international merchant descriptors. A different card is more effective than repeated retries against the same unsupported credential.
Open in admin →Frequently asked questions
Why does currency_not_supported affect international subscribers more often?
Because many domestic cards are configured for local-currency use and have restrictions on foreign merchant categories, cross-border settlement, or recurring billing in non-home currencies. A subscriber in one country trying to pay a subscription denominated in another currency is much more likely to trigger issuer currency restrictions than a local customer paying domestically.
Can retry timing fix a currency_not_supported decline?
No. This is not a balance or issuer-window problem. The bank is rejecting the transaction format because the card cannot process that subscription currency. The practical fixes are changing the billing currency, using a different card, or moving the customer onto a local-market subscription offer that matches their issuer's supported currencies.
Detect this error automatically
Free cross-stack scan finds all billing errors in 60 seconds.
Run Free Scan →