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.

   

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. Example The example amount is $20.50</em>.</p><div class="table-wrap"><table><thead><tr style="background-color: white;" class="header"><td><p>Typed format string</p></td><td><p>Cultures using point as decimal mark</p></td><td><p>Cultures using comma as decimal mark</p></td><td colspan="1"><p>Notes</p></td></tr></thead><tr style="background-color: white;"><td><p>${0}

   $20.5

   $20,5&lt;/p&gt;&lt;/td&gt;&lt;td colspan="1"&gt;&lt;p&gt;Displays as many decimal places as the number has.&lt;/p&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr style="background-color: white;"&gt;&lt;td&gt;&lt;p&gt;${0:F0}

   $20

   $20&lt;/p&gt;&lt;/td&gt;&lt;td colspan="1"&gt;&lt;p&gt;&lt;em&gt;F0&lt;/em&gt; displays 0 decimal places without rounding.&lt;/p&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr style="background-color: white;"&gt;&lt;td&gt;&lt;p&gt;${0:F}

   $20.50

   $20,50&lt;/p&gt;&lt;/td&gt;&lt;td colspan="1"&gt;&lt;p&gt;&lt;em&gt;F&lt;/em&gt; without any number is taken as &lt;em&gt;F2&lt;/em&gt; and displays 2 decimal places.&lt;/p&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr style="background-color: white;"&gt;&lt;td colspan="1"&gt;&lt;p&gt;${0:F4}

   $20.5000

   $20,5000&lt;/p&gt;&lt;/td&gt;&lt;td colspan="1"&gt;&lt;p&gt;&lt;em&gt;F4&lt;/em&gt; displays 4 decimal places.&lt;/p&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr style="background-color: white;"&gt;&lt;td colspan="1"&gt;&lt;p&gt;${0:000.000}

   $020.500

   $020,500

   Instead of the F-notation, you can use 0-based notation. 000.000 displays at least three numbers before decimal mark and always three numbers after decimal mark.