# Currencies https://docs.wisecp.com/fr/currencies Choose the currencies you offer, set the one everything is priced against, and keep rates current. ## Reaching the Screen Panel menu: **Settings**, then **Billing Settings**, then **Currencies**: `{admin}/financial/currencies` Over 150 currencies ship with the product. You choose which ones clients may use. ## What Is on the Screen - **The two buttons**: **Currency Automation Settings** and **Update Currency Rates Now**. - **Automation state**: Scheduled update on or off, and when it last ran. - **The list**: One row per currency; search, page size, download, paging. - **The currency dialog**: Name, symbol, format, rate and countries for one currency. ### The automation band **Update Currency Rates Now** runs the job at once, even when automatic updating is off, and delays the next automatic run by a full period. **Automatically Update Rates** reads **Active** or **Inactive**. **Last Updated** reads **None** before the first run. ### The currency list Flag, name and code identify the row. Only the name is editable. - **Prefix/Suffix**: Both symbols in one cell. A dash means that side is empty. - **Conversion Rate**: The only sortable column. - **Default Currency**: A tick on one row: the base for every other rate. - **Hidden**: Marked when an active currency is hidden from the client area. - **Status**: On and off, applied at once. The default currency's is locked on. ### The currency dialog The arrow button on a row opens it; the fields are under **Fields**. **Save Changes** closes it and reloads the list. ## Fields ### Currency Automation Settings Each installed module has its own card, shown when you select it, asking for the provider's API key. **Test Connection** tries the typed values before saving and shows two sample rates with the total number received. - **Select Module**: Where rates come from. Nothing selected stops the scheduled update; a missing module falls back to the free built in one. - **Automatically Update Rates**: Switches the scheduled task on and off. Off freezes rates; the manual button still works. - **Currency Update Frequency**: Applies while the switch above is on. **Day** is the default, **Hour** the other choice. ### The currency dialog - **Name**: Shown wherever the currency is offered. The three letter code is fixed. - **Default Currency**: Only one currency carries it. Ticking it activates the currency and pins its rate to 1. Also on the localization settings screen. - **Hide from Clients**: Off by default. On, prices keep working but the currency leaves the client area switcher. - **Prefix/Suffix**: The symbols before and after the amount. Both empty, amounts show the currency code. - **Format**: **Default** follows the currency's own locale. Fixed choices: 1234.56, 1,234.56, 1.234,56, 1,234 and 1.234; the last two drop decimals. - **Conversion Rate**: One unit of the default currency buys this much. For the default currency the field locks at 1 and cannot be edited; elsewhere a typed rate holds until the next update. - **Currency related to country**: Optional. Visitors from these countries see prices in this currency at first visit. A country belongs to one currency. - **Acceptable Payment Methods**: Optional. Records which payment methods go with this currency. Checkout options come from the payment methods screen. ## Tasks ### Offer a currency to clients 1. Search for the currency by name or code. 2. Turn the switch in the **Status** column on. 3. Rates are fetched at once and the row's **Conversion Rate** is rewritten. 4. It appears in the client area switcher, unless **Hide from Clients** is ticked. ### Set the rates to update themselves 1. Click **Currency Automation Settings** and pick the provider in **Select Module**. 2. Fill in its card, then click **Test Connection**. 3. Turn **Automatically Update Rates** on and choose the **Currency Update Frequency**. 4. Click **Save Changes**. The band reads **Active** and the task runs on its own. ### Refresh the rates immediately 1. Click **Update Currency Rates Now** and wait. 2. If rates moved, the list reloads and **Last Updated** starts from zero. 3. If nothing moved, a message says so. ### Change the default currency 1. Open the currency with the arrow button. 2. Tick **Default Currency** and click **Save Changes**. 3. It is activated, its rate becomes 1, the old default loses the flag and every rate is fetched again. When a product has **Override client currency** enabled, it is sold only in its own currency: once such a product is in the cart, **the whole order locks to that currency** — the visitor's currency selection and the foreign-sale rule do not apply to the cart, and unflagged items are converted into the order currency at the current rate. The note under the order summary states which currency the order is invoiced in and which product set the lock. A second flagged product tied to a different currency is not rejected; it is converted into the locked currency and the note says so (the lock follows the flagged product priced in the installation's local currency, otherwise the earliest flagged item in the cart). Service renewals follow the same currency: the order-time currency is stamped on the service and renewal invoices are issued with it. The service page's "Renewal Price" shows that currency too. When the installation country is Türkiye and the default currency is Turkish Lira, orders with a billing address abroad are invoiced in a foreign currency. The client's selected currency is used when it is an active foreign one; otherwise USD, and failing that the first active foreign currency. The order summary tells the client so; the payment module's **Currency Conversion** setting still applies on top. ## Things to Watch > **The default currency moves, never clears** > > You cannot un-tick **Default Currency**, only move it, which activates the new one. Existing invoices keep their own currency. > **The switch is saved before the rates are** > > If the provider fails, the switch springs back but the change is already stored. Reload the list to see its real state. Converted amounts stay wrong until an update succeeds. > **Rate fetches are rationed by the day** > > One daily counter covers every fetch: scheduled task, manual button, activating a currency, changing the default. 47 go through, the 48th waits for the next day. Hourly updating spends 24 alone. ## Required Privileges Everything on this screen needs `FINANCIAL_CURRENCIES`. Downloading the list follows `TABLE_EXPORT`. The localization settings screen needs `SETTINGS_LOCALIZATION_CONFIGURE`. ## Related Articles - [Taxation](https://docs.wisecp.com/en/taxation) - [Payment Methods](https://docs.wisecp.com/en/payment-modules) - [Localization Settings](https://docs.wisecp.com/en/localization-settings) - [Automation Overview](https://docs.wisecp.com/en/automation-overview)