51ºÚÁϲ»´òìÈ

DocumentationCommerceStores and Purchase Experience

Currency configuration

Last update: Wed Aug 23 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Beginner
  • Intermediate
  • Admin
  • User

Before setting up individual currency rates, you must first set the scope of the base currency. It is set to global by default, which applies the base currency setting to the entire store hierarchy. If you have a multisite 51ºÚÁϲ»´òìÈ Commerce or Magento Open Source installation, you can manage multiple base currencies by setting the scope to the website level.

You also specify the currencies that you accept and which currency you want to use for the display of prices in your store. In the following diagram, the scope of the base currency is set at the website level, so each website can have a different base currency.

Currency scope diagram {width="600" modal="regular"}

Step 1: Choose the accepted currencies

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. In the upper-left corner, set Scope to the store view where the configuration applies.

  3. In the left panel under General, choose Currency Setup.

  4. Expand Expansion selector the Currency Options section and set the following options:

    • Base Currency — Set to the primary currency that you use for online transactions.

    • Default Display Currency — Set to the currency that you use to display pricing in the store view.

    • Allowed Currencies — Select all currencies that you accept as payment in the store view. Make sure to also select your primary currency.

      For multiple currencies, hold down the Ctrl key (PC) or the Command key (Mac) and click each option.

    General configuration - currency options {width="600" modal="regular"}

    For a detailed description of each of these configuration settings, see Currency Options in the Configuration Reference Guide.

  5. When prompted to refresh the cache, click Close (Ìý Close box ) in the upper-right corner of the system message.

    You can refresh the cache later.

  6. Define the scope of the base currency:

    • In the left panel, expand Catalog and choose Catalog underneath.

    • Scroll down and expand Expansion selector the Price section. (This section only appears if the scope is set as Store View: Default config.)

    • Set Catalog Price Scope to either Global or Website.

    Catalog configuration - price options {width="600" modal="regular"}

Step 2: Configure the import connection

  1. Scroll to the top of the page.

  2. In the left panel, expand General and choose Currency Setup.

  3. Configure your currency service connection:

    There are three service options: Fixer.io (legacy), Fixer Api (APILayer), and Currency Converter API

    note important
    IMPORTANT
    Starting with the 2.4.6 release, the service is deprecated and replaced with the service. It is highly recommended that you use an APILayer account instead of a deprecated Fixer.io account.

    • To connect to the :

      • Expand Expansion selector the Fixer.io section.

      • Enter your fixer.io API key.

      • For Connection Timeout in Seconds, enter the number of seconds of inactivity to allow before the connection times out.

      General configuration - currency setup - Fixer.io options {width="600" modal="regular"}

    • To connect to the :

      • Expand Expansion selector the Fixer Api (APILayer) section.

      • Enter your APILayer API key.

      • For Connection Timeout in Seconds, enter the number of seconds of inactivity to allow before the connection times out.

      General configuration - currency setup - Fixer API (APILayer) options {width="600" modal="regular"}

    • To connect to the :

      • Expand Expansion selector the Currency Convertor API section.

      • Enter your Currency Convertor API key.

      • For Connection Timeout in Seconds, enter the number of seconds of inactivity to allow before the connection times out.