Multi-Currency
Multi-Currency Support
Cartly supports selling in multiple currencies, allowing you to display prices in your customers' preferred currency.
Setting Your Base Currency
Your base currency is set during store creation and is used for all internal price storage. All product prices, order totals, and reports use the base currency. Navigate to Settings ā General to view your base currency.
Enabling Additional Currencies
Go to Settings ā Currencies to enable additional currencies for your storefront. When a customer visits your store, prices are displayed in their selected currency based on the current exchange rate.
Exchange Rates
Cartly manages exchange rates through the exchange_rate entity. Rates can be:
- Automatic ā Updated periodically from external rate providers
- Manual ā Set custom rates that you control. Useful for markets where you want fixed pricing.
You can view and adjust exchange rates in the admin panel. Manual overrides take precedence over automatic rates.
Price Display
When a customer selects a currency, all prices are converted from your base currency using the applicable exchange rate. The storefront shows prices in the selected currency with the correct symbol and formatting (e.g., $29.99, 27.49 EUR, 3,299 JPY).
Checkout Currency
At checkout, the payment is processed in the currency the customer selected. Stripe handles the currency conversion on the payment side. The order is recorded in both the display currency and your base currency for accurate reporting.
Rounding Rules
Converted prices are rounded to the appropriate number of decimal places for each currency. Most currencies use 2 decimal places, while some (like JPY) use 0. Cartly applies the correct rounding rules automatically.
Reporting
All analytics and reports show amounts in your base currency, even for orders placed in other currencies. This ensures consistent financial reporting regardless of the currencies your customers use.