Using AI coding agents like Claude Code or Cursor? Try the official Chargebee Agent Skills to speed up your development.Try now
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.