Managing currency rates

A currency rate is the rate at which one currency is exchanged for another (see Viewing the list of currencies). Currency rates are used for calculating charges when the plan currency (see Plan information) differs from the reseller currency (see Creating a new reseller).

By default, all currency rates are equal to 1. It is important to update the currency rates for the required currencies with the actual values.

Reverse exchange rates do not depend on direct rates and are not calculated automatically. Reverse exchange rates must be specified individually for each currency when needed.

Currency rates are set on the root reseller level and automatically applied to resellers on all downstream levels if a downstream reseller did not specify the custom currency rate.

Changing the currency rate may affect prices in Customer Store (see Managing Customer Store currency). Prices displayed in Customer Store in the reseller currency will be updated with the new currency rate only after synchronization (see Managing synchronization of data).

The following operations with currency rates are available:

Viewing and updating currency rates on the root reseller level

To view currency rates on the root reseller level:

  1. Sign in to the Operator Control Panel on the root reseller level.
  2. Go to Currency Rates (see Navigation). The list of currencies is displayed.



    The list includes the following columns:

    • ID — the unique identifier of a currency in the platform.
    • Currency code — the currency code (ISO 4217).
  3. Click the ID or name of the required currency, The page with the exchange rates of the selected currency is displayed.



    The page includes the list of exchange rates for the selected currency to all available currencies with the following columns:
    • Currency code — the currency code (ISO 4217).
    • Unit — the number of currency units used for the currency rate.
    • Exchange rate — the currency rate for the specified number of currency units.
    • Show in Customer panel — the checkbox for displaying the currency rate in the Customer Control Panel.

To update the currency rate on the root reseller level, on the page with the exchange rates of the selected currency:

  1. In the Unit field, enter the number of currency units used for the currency rate (positive integer).
  2. In the Exchange rate field, enter the value of the rate with up to 4 decimal places.
  3. Click Save. The specified currency rate is applied to resellers on all downstream levels if a downstream reseller did not specify the custom currency rate.


Example

A reseller sells subscriptions to a product in USD (the reseller currency). A vendor specifies the prices in EUR (the plan currency). To fix prices for the product in EUR for customers, the reseller needs to set the currency exchange rate as follows:

  1. On the Currency rates page, select USD (the reseller currency).
  2. On the Currency rates for USD page, set Units and Exchange Rate for EUR (the plan currency).
  3. Update the currency rate when needed.

Viewing currency rates on a downstream reseller level

To view currency rates on a downstream reseller level:

  1. Sign in to the Operator Control Panel on a downstream reseller level.
  2. Go to Currency Rates (see Page navigation). The list of currencies is displayed.
  3. Click the ID or name of the required currency, The page with the exchange rates of the selected currency is displayed.



    The page includes the list of exchange rates for the selected currency to all available currencies with the following columns:
    • Currency code — the currency code (ISO 4217).
    • Unit — the number of currency units used for the currency rate.
    • Exchange rate — the currency rate for the specified number of currency units.
    • Show in Customer panel — the checkbox for displaying the currency rate in the Customer Control Panel.
    • Currency rate management — one of the following buttons:
      • Change Rate — displayed if the currency rate is inherited from the root reseller.
      • Cancel — displayed if the downstream reseller set the custom currency rate.

Specifying a custom currency rate on a downstream reseller level

To change a currency rate inherited from the root reseller and specify the custom currency rate on a downstream reseller level:

  1. Sign in to the Operator Control Panel on a downstream reseller level.
  2. Go to Currency Rates (see Page navigation). The list of currencies is displayed.
  3. Click the ID or name of the required currency, The page with the exchange rates of the selected currency is displayed.
  4. In the row with the required currency:
    1. Click Change Rate. The Unit and Exchanging Rate fields become available for editing, the Cancel button is displayed.
    2. In the Unit field, enter the number of currency units used for the currency rate (positive integer).
    3. In the Exchange rate field, enter the value of the rate with up to 4 decimal places.
  5. Click Save. The specified currency rate is applied to this reseller only.

Cancelling a custom currency rate on a downstream reseller level

To stop using the custom rate for a currency and switch to the rate specified on the root reseller level:

  1. Sign in to the Operator Control Panel on a downstream reseller level.
  2. Go to Currency Rates (see Page navigation). The list of currencies is displayed.
  3. Click the ID or name of the required currency. The page with the exchange rates of the selected currency is displayed.
  4. In the row with the required currency, click Cancel. The Unit and Exchanging Rate fields become unavailable for editing, the Change Rate button is displayed.
  5. Click Save. This downstream reseller will use the currency rate specified on the root reseller level.

Displaying currency rates in the Customer Control Panel

The Customer Control Panel supports displaying up to 5 currency rates of the reseller on the current level (see Screen layout). By default, no currency rates are displayed.

To activate displaying the exchange rate for a currency:

  1. Sign in to the Operator Control Panel on the required reseller level.
  2. Go to Currency Rates (see Page navigation). The list of currencies is displayed.
  3. Click the ID or name of the reseller currency. The page with the exchange rates of the reseller currency is displayed.
  4. In the row with the required currency, in the Show in Customer panel column, select the checkbox.



  5. Optionally, select the checkboxes for other currencies. The maximum number of currencies with the selected checkboxes is 5.
  6. Click Save. In the Customer Control Panel, for the currencies with the selected checkboxes, the exchange rate against the reseller currency is displayed.