currency_not_supportedThe card doesn't support this currency
Stripe's currency_not_supported decline means the card can't be charged in the payment's currency. What the customer should check with their bank.
- Next step
- Customer should contact their bank
- Hard decline
- Not on Stripe's list
- Share the reason
- Yes
What does currency_not_supported mean?
The card doesn't support the currency of the payment.
What Stripe says to do
The customer needs to check with their issuer whether the card can be used in that currency.
What to tell the customer
Tell the customer the card can't be charged in this currency, and suggest another card or a call to their bank.
Your card can't be charged in this currency. Please use a different card, or check with your bank.
Should you retry currency_not_supported?
Not in the same currency on the same card. It isn't on Stripe's hard decline list, so Stripe Billing retries follow your Smart Retries or custom schedule.
Before any retry, check the charge's outcome.advice_code. try_again_later means the issuer allows a retry, do_not_try_again means don't use the card again for this transaction, and confirm_card_data means some card details need checking.
Where currency_not_supported shows up
On a failed PaymentIntent, read last_payment_error.decline_code. On the Charge, the same code is in outcome.reason. Card declines usually come with the error code card_declined and the reason in decline_code.
With local payment methods
Stripe also returns currency_not_supported for local payment methods, with the Charge's outcome.reason set to partner_invalid_currency. Stripe's message: "The payment provider doesn't support this currency." Stripe says retries won't succeed.
Get failed payments in Slack
ChargeBell posts a Slack alert when a Stripe payment fails, with the amount, the customer, and Stripe's decline message. Open the payment from the alert to see its decline code, such as currency_not_supported, and follow up from there.