Configuring currencies

The Kentico E-commerce Solution allows you to use multiple currencies in your on-line store, in which your customers can pay for your products. Prices in all currencies are converted based on an exchange table.

One of the currencies is always the main currency. In the main currency, store administrators enter prices of all store items (e.g., product prices, shipping costs). You can also decide whether you want to use global currencies or site currencies.

To correctly set up currencies:

  1. Set whether you want to use site or global currencies.
  2. Create all currencies you want to use.
  3. Set one of the currencies as the main currency.
  4. Specify the exchange table.

Using site and global currencies

Before starting to create currencies, decide whether you want to use global currencies or site currencies. If you use more sites and you plan to use the same set of currencies with the same exchange rates on all of the sites, use global currencies. Otherwise, we recommend that you use site currencies.

  1. Open the Store configuration application (if you want to set the setting for the current site) or the Multistore configuration application (if you want to set the setting globally).

    If you are not sure what to choose, see Choosing site or global e-commerce configuration. If you are not sure about specifics of configuring in these applications, see Configuring e-commerce settings for a specific site or globally.

  2. Navigate to the Store settings -> Global objects tab.

  3. Set the Currencies field:

    • Clear the Inherit from global settings option (only if you work in the Store configuration application).
    • To use global currencies, select the checkbox. To use site currencies, clear the checkbox.
  4. Click Save.

The system now uses the specified type of currencies.

Creating currencies

To create a new currency:

  1. Open the Store configuration application (if you want to specify currencies for the current site) or the Multistore configuration application (if you want to specify them globally).

    If you are not sure what to choose, see Choosing site or global e-commerce configuration. If you are not sure about specifics of configuring in these applications, see Configuring e-commerce settings for a specific site or globally.

  2. Switch to the Currencies tab.

  3. Click New currency to add a currency.
    Clicking new currency

  4. Enter the following properties:

    Display name

    The name of the currency displayed to users on the live site and in the administration interface.

    Code name

    The unique identifier of the currency object used by developers in the code.

    Unless there is a reason to set a particular value, you can leave the default (automatic) option, and the system generates an appropriate code name automatically.

    Currency code

    A three-letter code of the currency used globally in banking and business. It is the official code of the currency used in exchange rates.

    Currency formatting string

    The format used to display amounts in the given currency. The {0} specifier represents the amount. For example, to display 50,type{0} to this field.

    For complete information about format strings, see MSDN.

    Decimal places

    The number of decimal places of prices used and displayed in your on-line store. The system rounds numbers that contains more decimal places.

    In the administration interface, you are then allowed to type more decimal places and the system saves the numbers with more decimal places; however, the system calculates with rounded numbers and also displays the rounded numbers on the live site.

    If you plan to use PayPal as a payment method, we recommend that you use two decimal places. Currencies that use more than two decimal places are rounded when the customer chooses PayPal for paying.

    Enabled

    Indicates if you can use the currency in your on-line store, for example when creating or editing an order.

    If you add a new currency to an already running site, disable it before you set exchange rates (and other properties if desired). Otherwise, the price of all paid items (products, shipping, etc.) will be 0 when switched to this currency.

  5. Save the currency.

The currency is now created and if you selected the Enabled field, the currency is ready to use on the site.

Setting up the main currency

The main currency can be specified for the site for site currencies or globally for global currencies.

We strongly recommend that you do not change an already set main currency on running websites. Stop the website first.

  1. Open the Store configuration application (if you want to specify the main currency for the current site currencies) or the Multistore configuration application (if you want to specify the main currency for global currencies).

  2. On the Store settings -> General tab, change the main currency.

    Configuring the main currency

  3. The dialog is different when you specify the main currency for the first time and when you want to change an already existing main currency.

    • If you specify the main currency for the first time, specify the New main currency field.
    • If you want to change an already existing main currency, you need to enter the following properties:
      • New main currency – specify the new main currency.
      • Exchange rate – specify the exchange rate used when recalculating prices and other e-commerce objects.
        • Type the rate in the form of how much money of the original main currency is needed for one unit of the new main currency. For example, when you change United States Dollars for Euros and the exchange rate is 1 USD = 0.90 EUR, type 1.1111 to the field (that is the result of 1 divided by 0.9), or when you change United States Dollars for Australian Dollars and the exchange rate is 1 USD = 1.30 AUD, type 0.7692 to the field (that is the result of 1 divided by 1.3).
      • Round to – specify the number of decimal places to which the recalculated price should be rounded.
      • Recalculate – specify what should be recalculated according to the specified values in the Exchange rate and Round to fields.
        • Objects which checkboxes you clear will be then left in the original value. For example, if you clear the Recalculate product prices checkbox and a specific product costs 10 USD, it will cost 10 EUR after changing the main currency from United States Dollar to Euros.
  4. Click Save & Close.

After changing the main currency, clear your cache by clicking Clear cache on the General tab in the System application.

The system changes the main currency and recalculates specified prices.

Using multiple currencies

To use multiple currencies, you need to establish an exchange rate table which recalculates the prices among the used currencies. You can set the exchange rate table on the Exchange rates tab in the Store configuration and Multistore configuration applications.

Generally, there are only two cases when you do not need to create an exchange table:

  • You use only one global currency (and no site currencies).
    -OR-
  • You use only one site currency and you do not use any global object (for example, global product or tax class).

See the whole documentation about exchange rates in Configuring exchange rates.