Difference between revisions of "Currencies"
(→Auto Updating Prices) |
|||
| Line 1: | Line 1: | ||
| − | You can configure the currencies | + | WHMCS supports all global currencies as well as syncing of product prices across currencies.= Currency support applies to all currency values throughout WHMCS, like product and addon pricing. It's included in your WHMCS experience automatically, with no need to enable or disable any settings. |
| − | + | ||
| − | + | You can configure the currencies in WHMCS at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Currencies''', or, prior to WHMCS 8.0, '''Setup > Payments > Currencies'''. | |
| − | + | ||
| + | WHMCS 8.0 includes improved currency support to allow you to enter larger numbers, up to 99 trillion (14 to the left of the decimal and 2 to the right). This allows you to easily work with currencies with large values like Indonesian Rupiahs (IDR), which are (at the time of this document's writing) valued at 14,830.85 IDR to 1 USD. | ||
| + | |||
| + | [[File:Currency99Trillion.png|600px|Currency Values Up To 99 Trillion]] | ||
| + | |||
==Changing the Default Currency== | ==Changing the Default Currency== | ||
| + | By default, the base currency is USD. Change it to your home currency if it's not USD. You can then add additional currencies. | ||
| + | |||
You can find a guide to changing the system default currency [https://help.whmcs.com/m/payments/l/1122770-changing-the-default-currency here]. | You can find a guide to changing the system default currency [https://help.whmcs.com/m/payments/l/1122770-changing-the-default-currency here]. | ||
| − | + | ||
| − | <html><a href="https://www.youtube.com/watch?v=Px1WjlmGDLw&hd=1" class="docs-video-tutorial"><em>Watch the video tutorial for this feature</em><span> | + | <html><a href="https://www.youtube.com/watch?v=Px1WjlmGDLw&hd=1" class="docs-video-tutorial"><em>Watch the video tutorial for this feature</em><span> <img src="https://assets.whmcs.com/icons/youtube.png"> </span></a></html> |
| − | + | ||
==Adding/Editing a Currency== | ==Adding/Editing a Currency== | ||
| − | + | ||
| − | <html><a href="http://www.youtube.com/watch?v=LFTVqImvPHw&hd=1" class="docs-video-tutorial"><em>Watch the video tutorial for this feature</em><span> | + | <html><a href="http://www.youtube.com/watch?v=LFTVqImvPHw&hd=1" class="docs-video-tutorial"><em>Watch the video tutorial for this feature</em><span> <img src="https://assets.whmcs.com/icons/youtube.png"> </span></a></html> |
| − | + | ||
| − | The fields for adding or editing a currency are the same | + | The fields for adding or editing a currency are the same: |
| − | + | ||
*Currency Code — The standard three-letter ISO-4217 code that payment gateways use. | *Currency Code — The standard three-letter ISO-4217 code that payment gateways use. | ||
*Prefix — The text or symbol to display before the amount. | *Prefix — The text or symbol to display before the amount. | ||
| Line 19: | Line 25: | ||
*Format — The format style for currencies. | *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. | *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: | + | To find the base conversion rate: |
#Go to [http://www.xe.com/ucc/ The Universal Currency Converter]. | #Go to [http://www.xe.com/ucc/ The Universal Currency Converter]. | ||
#Select your default currency in '''From this currency'''. | #Select your default currency in '''From this currency'''. | ||
#Select your second currency from '''To this currency'''. | #Select your second currency from '''To this currency'''. | ||
| − | #Click Go. | + | #Click '''Go'''. |
| − | + | ||
The base conversion rate will appear. For example: | The base conversion rate will appear. For example: | ||
| − | + | ||
[[Image:Bcr1.png]] | [[Image:Bcr1.png]] | ||
| − | + | ||
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. | 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== | ==Auto Updating Rates== | ||
| − | + | ||
WHMCS has the built-in capability to retrieve and update the base conversion rate values daily for the following currencies: | 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 | 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, [http://en.wikipedia.org/wiki/ISO_4217 view ISO-4217]. | For a full list of international currency codes, [http://en.wikipedia.org/wiki/ISO_4217 view ISO-4217]. | ||
| − | + | ||
| − | You can manually sync the rates using '''Update Exchange Rates''' | + | You can manually sync the rates using '''Update Exchange Rates'''. You can configure automation with the daily cron in '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Automation Settings''', or, prior to WHMCS 8.0, '''Setup > Automation Settings'''. |
| − | + | ||
==Auto Updating Prices== | ==Auto Updating Prices== | ||
| − | + | ||
| − | + | You can also automatically update prices in currencies other than the base rate using the rates you set. To do this, click '''Update Product Prices'''. You can also set this to run after the daily rates update at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Automation Settings''' or, prior to WHMCS 8.0, '''Setup > Automation Settings'''. | |
| − | + | ||
==Specifying Currency in a link== | ==Specifying Currency in a link== | ||
| − | + | ||
| − | You can link to the order form with a specific currency by | + | You can link to the order form with a specific currency by adding the required actions to the URL. For example, <tt>cart.php?currency=1</tt> or <tt>cart.php?currency=2</tt>. |
Revision as of 00:28, 19 September 2020
WHMCS supports all global currencies as well as syncing of product prices across currencies.= Currency support applies to all currency values throughout WHMCS, like product and addon pricing. It's included in your WHMCS experience automatically, with no need to enable or disable any settings.
You can configure the currencies in WHMCS at Configuration () > System Settings > Currencies, or, prior to WHMCS 8.0, Setup > Payments > Currencies.
WHMCS 8.0 includes improved currency support to allow you to enter larger numbers, up to 99 trillion (14 to the left of the decimal and 2 to the right). This allows you to easily work with currencies with large values like Indonesian Rupiahs (IDR), which are (at the time of this document's writing) valued at 14,830.85 IDR to 1 USD.
Contents
Changing the Default Currency
By default, the base currency is USD. Change it to your home currency if it's not USD. You can then add additional currencies.
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:
- 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:
- Go to The Universal Currency Converter.
- Select your default currency in From this currency.
- Select your second currency from To this currency.
- 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. You can configure automation with the daily cron in Configuration () > System Settings > Automation Settings, or, prior to WHMCS 8.0, Setup > Automation Settings.
Auto Updating Prices
You can also automatically update prices in currencies other than the base rate using the rates you set. To do this, click Update Product Prices. You can also set this to run after the daily rates update at Configuration () > System Settings > Automation Settings or, prior to WHMCS 8.0, Setup > 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.