Skip to content

Currencies

Currencies define the billing currencies available in the system. Each Account is assigned a currency at creation time — it determines the unit for balance, rates, and invoices and cannot be changed afterwards.

Vendor rates (Dialpeers) and destination rates (Destinations) are also expressed in a specific currency. At routing time, all rates are converted to the system base currency using the configured exchange rate, enabling accurate LCR comparisons and profit calculation across multiple currencies.

Exchange rates are stored in CDRs at call time, so billing history remains accurate even when rates are updated later.

System Currency

The system currency is a built-in currency with id = 0 and a fixed rate of 1.0. It serves as the base unit for all exchange rate calculations — all other currency rates are expressed relative to it. Its rate cannot be changed, but its name can be updated to match whatever currency your system uses as the base (e.g. USD).

Profit in CDRs is always expressed in the system currency, regardless of the currencies used by the customer account or vendor dialpeer.

Properties

Id
Auto-generated unique currency id.
Name
ISO 4217 currency code (e.g. USD, EUR, GBP). Must be unique. Selected from the standard list of supported currency codes.
Rate
Exchange rate relative to the system base currency. The base currency has a rate of 1.0. A rate of 1.2 means the currency is 1.2 times the base unit. Must be greater than zero.