> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fusioncore.us/llms.txt
> Use this file to discover all available pages before exploring further.

# Enabling Multi-currency

> Turn on Salesforce multi-currency so fusionCore can take payments, issue orders, and report in more than one currency.

Multi-currency is a Salesforce org-level setting. When you turn it on, Salesforce adds a standard `CurrencyIsoCode` field to currency-bearing records (Accounts, Contacts, Orders, and more) and maintains conversion rates between your org's **corporate currency** and every other currency you activate.

The corporate currency is the single base currency Salesforce converts everything back to for consolidated reporting. fusionCore reads `CurrencyIsoCode` when it creates orders, processes payments, and sends amounts to payment gateways, so this setting is the foundation for everything else in this section.

<Warning>
  Activating multiple currencies **cannot be undone**. Salesforce does not let you turn it off once it is enabled. Confirm you have agreement from all stakeholders before you proceed.
</Warning>

## Before You Start

* You need a Salesforce user with permission to edit **Company Information** (typically a System Administrator).
* Decide which currency will be your corporate currency. It does not have to be USD.
* Have the list of currencies you sell in ready, so you can activate and rate each one.

## Enable Multiple Currencies

<Steps>
  <Step title="Open Setup">
    At the top right of Salesforce, click the gear icon and select **Setup**.

    <Frame>
      <img src="https://mintcdn.com/fusionspan/4u-JGPkRA8QDMGYi/images/end-user-guides/4857593928/Screenshot_2025-01-07_at_11.46.09-AM.png?fit=max&auto=format&n=4u-JGPkRA8QDMGYi&q=85&s=4804f9282912aab4b1785886bd7e4de4" alt="Salesforce gear icon menu with Setup highlighted" width="562" height="464" data-path="images/end-user-guides/4857593928/Screenshot_2025-01-07_at_11.46.09-AM.png" />
    </Frame>
  </Step>

  <Step title="Open Company Information">
    In the **Quick Find** bar, type `Company Information`, then click **Company Information**.

    <Frame>
      <img src="https://mintcdn.com/fusionspan/4u-JGPkRA8QDMGYi/images/end-user-guides/4857593928/Screenshot_2025-01-07_at_11.46.31-AM.png?fit=max&auto=format&n=4u-JGPkRA8QDMGYi&q=85&s=e7d4094b4febfdd0d0596daf826f6aaf" alt="Quick Find search for Company Settings" width="492" height="360" data-path="images/end-user-guides/4857593928/Screenshot_2025-01-07_at_11.46.31-AM.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/fusionspan/4u-JGPkRA8QDMGYi/images/end-user-guides/4857593928/Screenshot_2025-01-07_at_11.53.14-AM.png?fit=max&auto=format&n=4u-JGPkRA8QDMGYi&q=85&s=a9f9c692c89cdb055ddff059292a3e09" alt="Company Settings menu with Company Information selected" width="500" height="636" data-path="images/end-user-guides/4857593928/Screenshot_2025-01-07_at_11.53.14-AM.png" />
    </Frame>
  </Step>

  <Step title="Edit the company information">
    On the **Company Information** detail page, click **Edit**.

    <Frame caption="Company Information detail page">
      <img src="https://mintcdn.com/fusionspan/4u-JGPkRA8QDMGYi/images/end-user-guides/4857593928/image-20260309-152310.png?fit=max&auto=format&n=4u-JGPkRA8QDMGYi&q=85&s=e5f8863befa42e6b011a21679c933031" alt="Company Information detail page with the Edit button" width="658" height="565" data-path="images/end-user-guides/4857593928/image-20260309-152310.png" />
    </Frame>
  </Step>

  <Step title="Activate multiple currencies">
    Check the **Activate Multiple Currencies** checkbox, then click **Save**.

    <Frame>
      <img src="https://mintcdn.com/fusionspan/4u-JGPkRA8QDMGYi/images/end-user-guides/4857593928/Screenshot_2025-01-07_at_11.55.29-AM.png?fit=max&auto=format&n=4u-JGPkRA8QDMGYi&q=85&s=06bf4c37569f8d443f3b470a3dab4426" alt="Activate Multiple Currencies checkbox on the Company Information edit page" width="1320" height="330" data-path="images/end-user-guides/4857593928/Screenshot_2025-01-07_at_11.55.29-AM.png" />
    </Frame>
  </Step>

  <Step title="Open Currency Setup">
    Back on the **Company Information** detail page, click **Currency Setup**.

    <Frame>
      <img src="https://mintcdn.com/fusionspan/4u-JGPkRA8QDMGYi/images/end-user-guides/4857593928/Screenshot_2025-01-07_at_11.58.01-AM.png?fit=max&auto=format&n=4u-JGPkRA8QDMGYi&q=85&s=423500ea1e4a638f6b0d13558e4ad6d8" alt="Company Information detail page with the Currency Setup button" width="894" height="278" data-path="images/end-user-guides/4857593928/Screenshot_2025-01-07_at_11.58.01-AM.png" />
    </Frame>
  </Step>

  <Step title="Activate and rate each currency">
    In the **Active Currencies** section, use the buttons and links to:

    * **New** — activate a currency you sell in (for example, `USD`, `EUR`, or `GBP`).
    * **Edit Rates** — set each currency's conversion rate against the corporate currency.
    * **Change Corporate** — choose which active currency is the corporate currency.
    * **Deactivate** — retire a currency you no longer offer.

    Activate every currency you intend to transact in, and set a conversion rate for each one.
  </Step>
</Steps>

<Info>
  A corporate currency must always be selected. It does not have to be USD, but only one corporate currency can be set at a time. Your choice affects how every exchange rate is expressed, because all rates are relative to the corporate currency.
</Info>

## What to Do Next

Enabling multi-currency is only the first step. To finish setting up, also:

* [Define Business Unit currency](/end-user-guides/accounting/multi-currency/defining-business-unit-currency) so each business unit transacts in the right currency.
* [Set Supported Currencies on Payment Types](/end-user-guides/accounting/multi-currency/supported-currencies-on-payment-type) to scope payment methods to specific currencies.
* [Create multi-currency orders from an Account or Contact](/end-user-guides/accounting/multi-currency/creating-multi-currency-orders-from-account-contact).
* [Update the standard price validation rule](/end-user-guides/accounting/multi-currency/updating-standard-price-validation-rule) if you need per-currency standard prices.

## Limitations and Common Pitfalls

* **Activation is irreversible.** Once multiple currencies are active, Salesforce provides no way to turn the setting off.
* **Activate and rate currencies before you transact.** fusionCore raises a "currency not supported" error when it tries to convert to or from a currency that has no active, rated currency in Setup. A currency that exists only as a label, with no conversion rate, will fail.
* **Conversions use Salesforce's stored rates.** fusionCore reads the current conversion rate you set in **Currency Setup** and rounds converted amounts to two decimal places. If you use Salesforce Advanced Currency Management (dated exchange rates), verify the converted figures, because the current rate is used rather than a date-specific rate.
