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.

For more information, see Change the Default Currency.

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 to GBP could be 1.5.
    • You can enter numbers up to 99 trillion (14 to the left of the decimal and 2 to the right).

Add a Currency

To add a new currency, enter the desired information under Add Additional Currency and click Add Currency.

Adding a 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.

For more information, see Find a Base Conversion Rate.
You cannot edit the base conversion rate for the default currency.

Exchange Rates

WHMCS uses the ECB API to retrieve exchange rates. Automatic rate updates only support the currencies below.

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.

For steps to configure automatic pricing updates, see Automatically Update Prices.

To do this manually, click Update Product Prices or set this to run after the daily rates update at Configuration () > System Settings > Automation Settings.

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.

currencies

Last modified: December 17, 2024