Customers buy more readily when they see prices in their own currency. WHMCS supports multiple currencies: each client account has one currency, and products and domains can have prices per currency – either set by hand or calculated from exchange rates. This guide covers the setup and the pitfalls.
Before you start
- Decide your base currency: the currency your reports and accounting use. Change it only before you have clients and transactions.
- Check which currencies your payment gateways accept.
Add a currency
- Go to Configuration → System Settings → Currencies.
- In Add Additional Currency, enter the Currency Code (ISO, e.g.
EUR), Prefix (e.g.€), Suffix (e.g.EUR), the Format (decimal and thousands separators) and the Base Conv. Rate relative to your base currency. - Click Add Currency.
Keep exchange rates current
- Click Update Exchange Rates on the Currencies page to fetch current rates.
- In Configuration → System Settings → Automation Settings, enable Exchange Rates Update so the daily cron refreshes them.
- Enable Update Product Prices only if you want prices in other currencies recalculated automatically from rates – convenient, but your prices will change daily and end in odd amounts.
Set prices per currency
Each product's Pricing tab shows a row per currency. Many hosts prefer fixed, rounded prices per currency (for example 4.99 USD and 4.49 EUR) rather than automatic conversion. Click Update Product Prices once on the Currencies page to fill all products from rates, then round the values by hand.
Do the same for domains under Domain Pricing → Open Pricing, and for addons and configurable options. A product with no price in a currency is hidden from clients using that currency.
How clients get a currency
- Visitors can pick a currency in the cart's currency selector; WHMCS can also pre-select it based on location.
- The currency is saved on the client account at registration. Change it later in the client profile – only while the client has no unpaid invoices, because existing invoices keep their currency.
Gateways and currencies
If a gateway does not support a client's currency, set the gateway's Convert To For Processing option to a supported currency. WHMCS converts the invoice amount at the stored exchange rate when sending the customer to pay, and records the payment in the invoice currency. Tell customers that their bank may add conversion fees.
Reporting
Reports in WHMCS can be filtered by currency, and income reports convert to the base currency using stored rates. For accounting, export transactions per currency.
Troubleshooting
- Product missing for some visitors: no price set in their currency.
- Gateway rejects the payment: currency unsupported and no conversion configured.
- Prices changed unexpectedly: Update Product Prices is enabled in automation.
- Cannot delete a currency: clients or invoices still use it.