Skip to main content

Managing Currencies

In your organizations, you can manage currencies from SYSTEM > Organization Settings > Currencies tab.

You can set up any currency as your organization's default currency as long as the currency's Enabled and Default checkboxes are selected while creating or editing a currency.

note
  • In Commerce Manager, when you create a new currency in your organization, a store belonging to that organization may not immediately inherit that currency. You might have to click the ellipsis associated with the currency Code, select Edit, and then click Save to see the new organization-level currency. See Edit a Currency.
  • In the API, when an organization creates a new currency or if there is a mismatch between the store currencies and organization currencies, pass an empty request body on a store-level currency using the Update a Currency endpoint to invalidate the cache. This will ensure that the store currencies are updated with the new organization currency.

Create a Currency​

  1. In Commerce Manager, go to SYSTEM > Organization Settings > Currencies tab.

  2. Click New Currency.

  3. Enter the following information:

    Field namesDescription
    CodeA three-letter currency code. For example: JPY for the Japanese Yen. It is recommended that you use the ISO 4217 currency code standard. See https://www.iso.org/iso-4217-currency-codes.html or https://en.wikipedia.org/wiki/ISO_4217.
    Exchange RateThe exchange rate from the default currency.
    FormatSpecify how the price currency is displayed. For example, ¥{price} is the format of the Japanese Yen when displayed in text. Depending on localization, a common value for this field might be something like ${price}, if the currency is to be USD. Canadian French however, uses the symbol as a suffix, so in that case it would be {price}$.
    Decimal pointThe decimal point character. For example, ..
    Thousands separatorThe thousand separator character. For example, ,.
    Decimal placesHow many decimal places the currency is formatted to? For example, the US dollar is formatted to two decimal places.

  4. (Optional) Select the Default checkbox if you want to set this as the default currency for your organization.

    caution
    • The Default checkbox is enabled only if you select the Enabled checkbox.
    • You cannot delete the organization's default currency.

  5. Select the Enabled checkbox if you want to enable this currency in your organization.

  6. Click Save. Once the Default checkbox is selected and the currency is saved, you cannot deselect the Default checkbox.

Edit a Currency​

  1. In Commerce Manager, go to SYSTEM > Organization Settings > Currencies tab.

  2. Under the Actions column, click the ellipsis associated with the currency Code.

  3. Select Edit and modify your changes.

  4. Click Save.

    caution

    You cannot deselect the Default checkbox. If you want to change the default currency, you must edit another currency to be the default currency.

Delete a Currency​

  1. In Commerce Manager, go to SYSTEM > Organization Settings > Currencies tab.

  2. Under the Actions column, click the ellipsis associated with the currency Code.

  3. Select Delete.

    You cannot delete the default currency. If you want to delete the default currency, you must first make another currency as the default currency. See Edit a Currency.