Currencies

You can configure the currencies you wish to use in your WHMCS installation in Configuration () > System Settings > Payments > Currencies.

By default, the base currency is USD. You can edit this, and should change it to your home currency if it's not USD. You can then add additional currencies.

Changing the Default Currency

You can find a guide to changing the system default currency here.

Watch the video tutorial for this feature  

Adding/Editing a Currency

Watch the video tutorial for this feature  

The fields for adding or editing a currency are the same. Below is an explanation of each of these:

• 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 format style for currencies.
• Base Conv. Rate — The rate by which to divide amounts in this currency to get to the base currency. For example, USD to GBP could be 1.5.

To find the base conversion rate:

1. Go to The Universal Currency Converter.
2. Select your default currency in From this currency.
3. Select your second currency from To this currency.
4. Click Go.

The base conversion rate will appear. For example:

The first currency is the default. If you want to define a default currency, you must edit the currency code and set it to the new default currency.

Auto Updating Rates

WHMCS has the built-in capability to retrieve and update the base conversion rate values daily for the following currencies:

USD, EUR, JPY, BGN, CZK, DKK, EEK, GBP, HUF, LTL, LVL, PLN, RON, SEK, CHF, NOK, HRK, RUB, TRY, AUD, BRL, CAD, CNY, HKD, IDR, INR, KRW, MXN, MYR, NZD, PHP, SGD, THB, and ZAR

For a full list of international currency codes, view ISO-4217.

You can manually sync the rates using Update Exchange Rates on the currencies page. You can configure automation with the daily cron in Configuration () > System Settings > Automation Settings.

Auto Updating Prices

WHMCS also provides the ability to automatically update the prices in currencies other than the base rate based on the rates you set. You can invoke this manually from the currencies page by clicking Update Product Prices, or have it run after the daily rates update in Setup > Automation Settings.

Specifying Currency in a link

You can link to the order form with a specific currency by simulating the actions for the form. For example, cart.php?currency=1 cart.php?currency=2.