← All Stripe decline codes

Stripe decline code

currency_not_supported

The card cannot accept charges in the currency you tried to use.

Type

Hard decline

Recoverable

Partially recoverable

Frequency

Uncommon

What does currency_not_supported mean?

currency_not_supported is common when a merchant bills in USD but a customer's card only supports their local currency, or vice versa. Some networks allow forex at the card level; others reject the charge. The fix is usually multi-currency support on the merchant side.

Recovery strategy

Retry approach

Do not retry the same currency. Offer an alternative currency or ask for a different card.

Customer message

Apologize for the currency mismatch and offer to bill in the customer's local currency if you support it.

Best practices

  • Support multiple billing currencies on Stripe (Stripe supports 135+ currencies)
  • Detect customer country via GeoIP or billing address and offer local currency by default
  • Monitor currency_not_supported rates by country to spot missing currency support

About hard declines

Permanent issue. The card cannot be charged. Customer must provide a new payment method.

Frequently asked questions

Does Stripe do automatic FX conversion?

Stripe can present a checkout in a customer's local currency if you enable multi-currency pricing or use Stripe Adaptive Pricing. The customer's card is still charged in whatever currency you set, but you can pick any of 135+ supported currencies.

How Rebounce handles currency_not_supported

Automatic hard decline handling, no code required

Rebounce classifies every failed payment by its Stripe decline code and applies the optimal recovery strategy automatically. For currency_not_supported, that means a limited retry window combined with customer outreach. Multi-channel follow-up through email, SMS, WhatsApp, and in-app banners ensures the customer actually sees the message.

Start free trial