List of ErrorsThe card does not support transactions in the selected currency. This can happen when the card issuer does not allow multi-currency transactions, the card is region-locked, or regulatory restrictions prevent currency conversions.
gateway.payment_method.card_currency_not_supported
Recommended Customer Message
Your card is not supported for this currency. Please check and correct your payment details before trying again.Root Cause
- Unsupported currency: The card issuer does not support transactions in the specified currency.
- Card product limitations: Some cards, especially region-locked or local currency cards, cannot process multi-currency transactions.
- Gateway configuration restrictions: Your payment gateway does not support currency conversions for the attempted card type.
- Regulatory restrictions: The issuing bank prevents currency conversions based on local financial regulations.
Troubleshooting and Solutions
- Ask the customer to retry the transaction using a card that supports international or multi-currency transactions.
- Recommend the customer contact the card issuer to confirm if currency support can be enabled for the card.
- Verify that the merchant account, payment gateway, and Chargebee are configured to support the required transaction currency.
- Clearly display supported currencies in the product or plan page to help customers choose the appropriate payment method.
- Offer alternative payment methods that support multi-currency transactions.