1.6.8 Currencies

There is one main (base) currency in the VoipSwitch system, with a fixed ratio value of 1.0 and id_currency=1 in the currencies table. Although the main currency name and symbol in currency_names table can be changed to any available in the database, the main currency ratio cannot be changed.

Additional currencies can be defined in relation to the main currency using ratios which are stored per each currency in the currencies table. These ratios are used when saving clients' call costs as shown in the currency processing diagram.

The costs of every call are saved in the system database using the main currency. If a client was configured with a different currency, the cost of his call is divided by the last defined currency ratio of that currency and then saved to the database.

The VSM displays clients' calls and other costs reports in the main currency.

Adding new currency

Currency management is in the Settings/Currencies menu. You can add currency by selecting it from the list of all available currencies from the popup windows after pressing the ADD button.

Next, in the edit mode you have to set the exchange rate between the new currency and the base currency. If the main system currency is USD, and we want to add EUR as an additional currency for clients the ratio defined in the system should be for example (USD/EUR) 0.7692 (1.00 USD = 0.7692 EUR).
For GBP the ratio should be (USD/GBP) 0.6395 (1.00 USD = 0.6395 GBP).

Assigning currency to client account

When adding a new client account the currency has to be chosen. Based on this selection the available tariffs in the dropdown list will be narrowed to the ones in the chosen currency. For example if you select USD then only the USD based tariffs will be shown. The system does not allow for assigning tariffs based on different currencies.  Client's account balance, credit limit, credit balance and any type of payments will be defined in the same currency.

The self-care portal (VUP) shows the tariff rates, balance and payments in the same currency too.

Once the currency is assigned to the client it cannot be changed. Future changes are not allowed because of the implications it would have as all the past costs, transactions and balance would have been in another currency.

Tariffs

When adding a new tariff or in the tariff settings screen of the existing one you can choose the tariff’s currency.

The rates in the tariff must be in the same currency.

Client’s tariffs must be match the client’s currency.  When a call is made its cost, calculated based on the rates from the tariff, is deducted from the account balance which must be in the same currency. The cost written to the calls table is converted to the base currency.

The tariffs assigned to destinations (cost tariffs) such as gateways and registrars must be defined in the main currency. The cost tariffs are managed from the Calls routing//Gateways or Registrar menu respectively.

Resellers

Accounts with different currency under one reseller are supported. The system calculates the call cost for the client and separately for the reseller according to its tariff and currency. The reseller currency is taken from the assigned base tariff. The reseller cannot change the base tariff, it is assigned by the reseller of the higher level of the system administrator.

All reports and the reseller account balance are in the reseller’s base currency.

Callshop

Callshop clients can use different currencies, however, their cabins must use the same currency as the parent Callshop account.