Currencies
WHMCS supports all global currencies as well as syncing of product prices across currencies. Currency support applies to all currency values throughout WHMCS (for example, product and addon pricing). You can change WHMCS’s currency and set conversion rates from within the Admin Area.
You can access this feature at Configuration () > System Settings > Currencies.
The list of currencies displays all of the currently-configured currencies on your WHMCS installation.
Default Currency
By default, the base currency on new WHMCS installations is USD.
If your installation does not contain any transaction or invoice data, you can change this by selecting the country for that currency at Configuration () > Setup Wizard.
Currency Configuration
For each currency, you can configure the following settings:
- Currency Code — The standard three-letter ISO-4217 code that payment gateways use.
- Prefix — The text or symbol to display before the amount.
- Suffix — The text or symbol to display after the amount.
- Format — The currency format.
- Base Conv. Rate — The rate by which to divide amounts in this currency to find the base conversion rate.
- For example,
USD
toGBP
could be1.5
. - You can enter numbers up to 99 trillion (14 to the left of the decimal and 2 to the right).
- For example,
Add a Currency
To add a new currency, enter the desired information under Add Additional Currency and click Add Currency.
Edit a Currency
To edit an existing currency, click the appropriate Edit icon, make the desired changes, and click Save Changes.
If you updated the conversion rate, you can select Update Pricing to recalculate the prices in this currency using the new rate.
Currency Format
You can choose a currency format to match the styling customs of monetary amounts in different currencies.
The following non-decimal currencies must use the 1,234
currency format:
BYR
, BIF
, CLP
, KMF
, DJF
, HUF
, ISK
, JP
, MGA
, PYG
, RWF
, KRW
, VUV
Base Conversion Rate
You must set a base conversion rate for each currency that you add to WHMCS.
Exchange Rates
WHMCS can retrieve and update the base conversion rate values daily for the following currencies:
USD
, EUR
, JPY
, BGN
, CZK
, DKK
, GBP
, HUF
, PLN
, RON
, SEK
, CHF
, ISK
, NOK
, HRK
, TRY
, AUD
, BRL
, CAD
, CNY
, HKD
, IDR
, ILS
, INR
, KRW
, MXN
, MYR
, NZD
, PHP
, SGD
, THB
, and ZAR
You can manually sync these rates by clicking Update Exchange Rates or you can configure updates via the daily cron at Configuration () > System Settings > Automation Settings,.
Update Product Prices
You can automatically update prices in currencies other than the base rate using the rates you set.
To do this manually, click Update Product Prices or set this to run after the daily rates update at Configuration () > System Settings > Automation Settings.
Specifying Currency in a Link
You can link to the order form with a specific currency by adding the required actions to the URL.
For example, cart.php?currency=1
or cart.php?currency=2
.
Last modified: October 9, 2024