Stripe Error: Currency Not Supported — What It Means & How to Fix It
The issuer does not support the currency used in the charge.
What currency_not_supported means in Stripe
The right recovery response depends on whether the decline is temporary, customer-actionable, or unlikely to succeed without a new payment method.
- Decline type
- Hard or customer-action decline
- Retry guidance
- Use the decline type to decide whether to retry automatically, wait for customer action, or stop retrying this payment method.
Common causes
- Card limited to domestic currency only
- Cross-border currency restrictions
- Subscription configured in a non-supported settlement currency
How to fix it
- Charge in a supported currency when possible.
- Ask customer to use a different card that supports the currency.
- Display currency expectations before purchase.
Recovery email template
Use this as a starting point when the payment needs customer action.
Subject
Payment update needed for Currency Not Supported
Body
Hi {{customer_name}}, we could not process your latest payment. Please review or update your payment method here: {{billing_portal_link}}.
Related Stripe decline-code questions
What does currency_not_supported mean in Stripe?
It is a Stripe decline code that explains why the issuer or payment network rejected the payment.
Should I retry this failed payment?
Retry only when the decline is likely to recover. Hard declines usually need a new payment method first.
How can RetryKit help?
RetryKit classifies failed invoices, runs timed retries, sends dunning emails, and tracks recovered revenue.
Should you retry this Stripe error?
Hard decline: Hard decline until payment method or currency changes. RetryKit should focus on getting an alternate card or correcting billing currency.
Stop losing revenue to failed payments. RetryKit automatically recovers failed Stripe payments. Connect in 5 minutes.
Start with RetryKit