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 applies decline-aware recovery logic after a free Stripe OAuth connection.
Connect Stripe free