Stripe · Decline codes
What does the Stripe currency_not_supported decline code mean?
Checked
Stripe's currency_not_supported decline code means the card doesn't support the currency the payment was made in. Stripe says the customer needs to check with their issuer whether the card can be used for that currency. Retrying in the same currency will be declined again. The shopper can use a different card, or the store can charge in a currency the card accepts if it sells in more than one.
- Type
- Hard decline
- Who declined
- The card's bank
- Retry
- No, not in the same currency on the same card
- Shopper action
- Use another card, or ask the bank about foreign-currency payments
- Merchant action
- Offer the shopper's local currency if you sell in several
What PlatformDTC does
PlatformDTC's checkout treats currency_not_supported as a never-retry decline and does not offer a backup processor. On renewals, on the default fixed schedule and with Smart retry alike, it is never retried automatically. The subscription is held past due instead of cancelled, the card is marked blocked, and the customer is emailed a one-click link to add a new card, re-sent up to 4 times per billing cycle at least 3 days apart.
Why it happens
The issuer does not allow this card to pay in the currency of the order.
What the shopper can do
Try a different card or payment method, or ask your bank whether the card can pay in this currency.
What the store can do
If your store prices in more than one currency, showing the shopper's own currency can avoid this decline. Otherwise, point the shopper to another payment method.
Frequently asked questions
- Can the store fix currency_not_supported?
- Only by charging in a currency the card accepts. The card's currency restrictions are set by the bank.
- Is currency_not_supported a fraud signal?
- No. Stripe describes it as the card not supporting the specified currency.
Sources
- Stripe decline codes — Stripe
Related
- card_not_supported — The card can't be used for this kind of purchase.
- invalid_amount — The payment amount is invalid or above what the card allows.
- restricted_card — The card can't be used for this payment; it may have been reported lost or stolen.
- do_not_honor — The bank declined the card without saying why.
- do_not_try_again — Deprecated code: declined for an unknown reason; don't charge this card again.
- duplicate_transaction — An identical payment on the same card was submitted moments ago.
- expired_card — The card is past its expiry date.
- fraudulent — Stripe's fraud checks suspected the payment was fraudulent and blocked it.