# 🌍 Exchange Rates Manager (Multi-Currency Support)

The **Exchange Rates Manager** enables **multi-currency support** in the Glover platform. It allows the system to automatically convert prices between different currencies based on defined exchange rates.

You can access it under:\
**Dashboard → Settings → Currencies → Exchange Rates**

#### ⚙️ Enabling Exchange Rate Management

At the top of the page, you’ll find a toggle switch labeled **“Exchange Rate”**.

* 🟢 **Active** – Enables the exchange rate feature.
* ⚪ **Inactive** – Disables exchange rate management (currencies will display without conversion).

When **disabled**, a yellow alert appears:

> ⚠️ *Exchange Rate Disabled — Enable the exchange rate feature above to manage currency exchange rates.*

Once **enabled**, the table becomes editable and the **Update Rates** button becomes available.

#### 📅 Effective Date

Use the **Effective Date** field to specify the date the exchange rates should apply.\
You can also click **Load Rates** to load or refresh existing rates for that specific date (if available).

***

#### 🧾 Currency Table

The table lists all available currencies configured in the **Currencies** tab.

| Column            | Description                                                                       |
| ----------------- | --------------------------------------------------------------------------------- |
| **Currency**      | The name of the currency (e.g., Ghana Cedis, Indian Rupees).                      |
| **Code**          | ISO currency code (e.g., GHS, INR, USD).                                          |
| **Symbol**        | Symbol representation of the currency (e.g., GHS, ₹, $).                          |
| **Exchange Rate** | Defines how much 1 unit of the **base currency** equals in the selected currency. |

> 🛈 **Note:**\
> The **base currency** (highlighted in blue) always has a rate of **1.00000000** and cannot be edited.\
> All other rates represent the conversion rate **from the base currency to the listed currency**.

Example:

* Base currency: **USD ($)**
* GHS rate: **15.20**\
  → means **1 USD = 15.20 GHS**

#### 🔁 Updating Rates

1. Set the effective date (optional).
2. Enter or adjust the exchange rates for each currency.
3. Click **Update Rates** to save the new values.

The updated exchange rates will be used across:

* Price display for customers viewing in a different currency.
* Vendor pricing if configured for localized currency views.
* Conversion during payments or reporting where multi-currency support is active.

#### 🧩 System Behavior

* When **Exchange Rate is Active**, all module prices (Food, Taxi, Parcel, etc.) can automatically reflect the selected currency using the configured rates.
* When **Exchange Rate is Inactive**, all prices display in the **base currency** only.

***

#### 🪙 Example Display

| Currency                      | Code | Symbol | Exchange Rate |
| ----------------------------- | ---- | ------ | ------------- |
| Ghana Cedis                   | GHS  | GHS    | 15.20000000   |
| Indian Rupees                 | INR  | ₹      | 85.50000000   |
| United States Dollar *(Base)* | USD  | $      | 1.00000000    |

### 💵 Customer Currency Preference (In-App)

The Glover customer app supports **multi-currency display**, allowing users to view prices in their preferred local currency.

This feature enhances user experience and helps customers better understand product and service pricing in their own region.

Customers can choose their preferred currency directly from the **Profile Page** of the Glover app.

**Path:**\
**App → Profile → Currency**

<figure><img src="https://2231621966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVNlKuUeCM_uD7sLQnM%2Fuploads%2Fh1WSwSGidwhJZKj1PBt0%2FScreenshot%202025-10-05%20at%2009.24.22.png?alt=media&#x26;token=1559464d-fa83-4c83-8c11-130bc8020eb5" alt=""><figcaption></figcaption></figure>

When a user selects a currency:

* The preference is saved to their account.
* All displayed prices in the app are automatically converted using the **current exchange rate** configured in the admin panel.

***

#### 🔄 Conversion Behavior

Once a preferred currency is selected:

* ✅ **Converted:**\
  All prices shown in **listings, menus, categories, items, services, and other non-order views** are automatically converted from the base currency using the active exchange rates.
* 🚫 **Not Converted:**\
  Existing **orders and order history** remain in the **original base currency** they were placed with. This ensures accurate transaction tracking and consistency in accounting.

***

#### ⚙️ Conversion Logic

1. The system always stores prices in the **base currency** (e.g., USD).
2. When displaying prices to a customer:
   * It checks the user’s preferred currency (e.g., GHS).
   * It applies the exchange rate configured in the **Exchange Rates Manager**.
   * Example:
     * Base currency: USD ($)
     * Exchange rate (USD → GHS): 15.20
     * Item price: $10.00\
       → Displayed price: **GHS 152.00**
3. If the customer changes their preferred currency, all non-order prices instantly reflect the new conversion.

***

#### 🧩 Key Notes

* The conversion is **for display purposes only**; backend prices remain in the base currency.
* Exchange rates can be manually updated or automatically synced by the admin.
* The feature helps international customers understand approximate pricing before checkout.

***

#### 🪙 Example Scenario

| Context            | Base Currency | Customer’s Selected Currency | Displayed Price |
| ------------------ | ------------- | ---------------------------- | --------------- |
| Food item          | USD ($)       | GHS (Ghana Cedis)            | GHS 152.00      |
| Taxi fare estimate | USD ($)       | INR (Indian Rupees)          | ₹850.00         |
| Order receipt      | USD ($)       | (unchanged)                  | $10.00          |