> This page is for Docs.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# Configure Currency Lookup as a processor

> Use the Currency Lookup processor to add foreign exchange (FX) rates to events so that you can convert amounts from one currency to another during Mediation. The processor uses exchange rate types provided by Oanda and can work with static or event‑based currencies.

Use the Currency Lookup processor to add foreign exchange (FX) rates to events so that you can convert amounts from one currency to another during Mediation. The processor uses exchange rate types provided by Oanda and can work with static or event‑based currencies.

Navigate to **Mediation** > **Meters**

Create a **Custom** meter.

Select **Currency Lookup** as the processor. The Currency Lookup settings page is displayed.

Enter a name for the currency lookup component.

The **Operator ID** is a system‑generated, non-editable identifier for this operator, used in audit and API integrations.

In the **From** section, choose how to determine the source currency:

* Select a fixed currency if all events use the same "from" currency (for example, USD or EUR).
* Or select **From Event** and choose the event field that contains the source currency code (for example, sourceCurrency).

In the **To** section, choose how to determine the target currency:

* Select a fixed target currency (for example, USD) if all events should be converted into the same currency.
* Or select **From Event** and choose the event field that contains the target currency code (for example, billCurrency).

In the **Rate Type** section, choose which exchange rate type to use:

* Select a specific rate type such as MIDPOINT, BID, or ASK if the same type applies to all events.
* Or select **From Event** and choose the field that contains the rate type value if different events may require different rate types.

In the **Date Field** section, choose the event field that contains the date or timestamp used for the FX lookup.

transactionDate, usageDate, or eventTimestamp

Specify the **Time Format** that matches the data in that field.

yyyy‑MM‑dd or yyyy‑MM‑dd'T'HH:mm:ss

The processor uses this field and your tenant's timezone to identify which daily rate to apply.

In the **Rate Field Name** field, enter the name of the event field that will store the exchange rate.

fxRate, exchangeRate, or appliedRate

This field will be added to each event with the numeric FX rate. You can use this value later to compute converted amounts.

(Optional) If the processor exposes cache settings, specify the maximum number of cached FX lookups (cache size) and how long cached rates are kept before they are refreshed (cache expiration).

Larger caches and reasonable expiration values can improve performance for high‑volume meters.

Click **Save** to save the processor settings.