Skip to content

Commit

Permalink
Updates on the Currencies page
Browse files Browse the repository at this point in the history
  • Loading branch information
Marianna Koroleva authored and Marianna Koroleva committed Aug 4, 2020
1 parent f9c5b9f commit 0f75888
Showing 1 changed file with 29 additions and 24 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,9 @@ contributors: git.exileDev, git.ivkadp, git.mariannk

# Currencies

In nopCommerce, the **only primary store currency is used,**. Primary store currency is the currency against which all other allowed currencies will be configured. Although nopCommerce allows having multiple currencies for displaying your product prices, the primary currency is used for payment transactions with online payment gateways.
In nopCommerce, the **only primary store currency is used**. Primary store currency is the currency against which all other allowed currencies will be configured. Although nopCommerce allows having multiple currencies for displaying your product prices, the primary currency is used for payment transactions with online payment gateways.

If you are using an online payment gateway (such as PayPal, Google Checkout), the amount is sent to the payment gateway and will be the price you entered in primary store currency.
If you are using an online payment gateway (such as PayPal), the amount is sent to the payment gateway and will be the price you entered in primary store currency.

Primary store currency is used only by the store administrators. It is used for setting product prices and does not have to be the same as the published currencies.

Expand All @@ -19,61 +19,66 @@ nopCommerce uses an **exchange rate** to calculate the amounts for published cur

Exchange rates fluctuate on a daily basis. Therefore, you can edit the exchange rate as often as you need in order to stay current. Actual transactions are only handled in your store's primary currency. On credit card transactions, banks will usually make exchanges automatically based on the most current currency values.

To define **currency settings** go to **Configuration → Currencies**.
To define currency settings go to **Configuration → Currencies**.

![currencies1](_static/currencies/currencies1.png)
![Currencies](_static/currencies/currencies1.png)

From the **Current exchange rate provider** dropdown list, select the exchange rate provider that will be used to get live rates.

> [!NOTE]
>
> By default in nopCommerce there is only one exchange rate provider available - ECB. To get live rates from ECB you should select EUR as a primary exchange rate currency.
Select the **Auto update** enabled checkbox, to enable receiving an automatic update of currency rates every hour.
Tick the **Auto update enabled** checkbox, to enable receiving an automatic update of currency rates every hour.

Click **Save**.

> [!NOTE]
>
> By default, all the currency rates are updated once per hour. You can change currency rates updating settings in **System → Schedule tasks**, choose **Update currency exchange rates**.
![currencies2](_static/currencies/tasks.jpg)

Click **Save.**
![Schedule task](_static/currencies/tasks.jpg)

## Add a new currency

Click the **Add new** button.

![currencies3](_static/currencies/currencies3.png)

Define the **currency settings:**
Define the currency settings:

* Currency **Name**.
* **Currency code**.
* **Currency code**. For a list of currency codes, go to: https://en.wikipedia.org/wiki/ISO_4217
* Enter the exchange **Rate** against the primary exchange rate of the currency.
* From the **Display locale** dropdown list, select the display locale for currency values.
* Enter **Custom formatting** to be applied to the currency values. In this field, you can specify any symbols for the currency displaying in public store, number of decimal places and so on.
* In the **Limited to stores** select a pre-created store from drop-down list.
* Enter **Custom formatting** to be applied to the currency values. In this field, you can specify any symbols for the currency displaying in the public store, number of decimal places and so on.
* In the **Limited to stores** select a pre-created store from drop-down list. Leave the field empty in case this functionality is not required.
> [!NOTE]
>
> In order to use this functionality, you have to disable the following setting: **Catalog settings → Ignore "limit per store" rules (sitewide)**. Read more about multi-store functionality [here](xref:en/getting-started/advanced-configuration/multi-store).

* From the **Rounding type** drop-down list choose one of the types of rounding:
* Default rounding
* Rounding up with 0.05 intervals (0.06 round to 0.10)
* Rounding down with 0.05 intervals (0.06 round to 0.05)
* Rounding up with 0.10 intervals (1.05 round to 1.10)
* Rounding down with 0.10 intervals (1.05 round to 1.00)
* Rounding with 0.50 intervals
* Rounding with 1.00 intervals (1.01-1.49 round to 1.00, 1.50-1.99 round to 2.00)
* Rounding up with 1.00 intervals (1.01–1.99 round to 2.00)
* *Default rounding*
* *Rounding up with 0.05 intervals (0.06 round to 0.10)*
* *Rounding down with 0.05 intervals (0.06 round to 0.05)*
* *Rounding up with 0.10 intervals (1.05 round to 1.10)*
* *Rounding down with 0.10 intervals (1.05 round to 1.00)*
* *Rounding with 0.50 intervals*
* *Rounding with 1.00 intervals (1.01-1.49 round to 1.00, 1.50-1.99 round to 2.00)*
* *Rounding up with 1.00 intervals (1.01–1.99 round to 2.00)*

* Select the **Published** checkbox, to enable this currency to be visible and selected by visitors in your store. nopCommerce supports a multi-currency pricing display. If you have several published currencies, customers will be able to select the currency they want.
* In the **Display order** field, enter the display order of this currency. A value of 1 represents the top of the list.

Click **Save.**
Click **Save**.

## Get live rates

Click **Get live rates** in the *Currencies* window. The panel is expanded in the bottom of the page as follows:
Click the **Get live rates** button in the top right of the *Currencies* window. The panel is expanded in the bottom of the page as follows:

![currencies4](_static/currencies/live-rates.jpg)
![Live rates](_static/currencies/live-rates.jpg)

Click **Apply all** here or apply manually new rates for all the needed currencies using the **Apply rate** buttons.
Click **Apply all** here or apply manually new rates for all the needed currencies using the **Apply rate** button.

## Tutorials

Expand Down

0 comments on commit 0f75888

Please sign in to comment.