---
url: /geosync-pro-whmcs/features/currency-localisation.md
description: >-
  How GeoSync Pro detects each visitor's country from their IP and switches your
  WHMCS client area to the right currency — with the EU rule, default-currency
  fallback, registration auto-switch and logged-in protection.
---

# Currency localisation

GeoSync Pro shows every guest prices in **their** local currency automatically — a visitor from India sees INR, one from the UK sees GBP — with no manual switching and no pop-ups.

![The Currency Localisation tab in the WHMCS admin](/geosync-pro-whmcs/img/geosync-currency-localisation-tab.png)
*Addons → GeoSync Pro → Currency*

## How it works, end to end

1. **Country detection:** Identifies the guest's country from their public IP via `ip-api.com`.
2. **Session caching:** Caches detected country for the visitor's session (~1 hour) to eliminate repeated lookups.
3. **Currency mapping:** Matches the ISO alpha-2 country code (e.g. `IN`, `GB`, `JP`) against your configured mapping table.
4. **The EU rule:** Maps all 27 EU member states simultaneously using the single code `EU`.
5. **Default fallback:** Applies your **Default Currency** if a country is undetectable or unmapped.

::: info How it decides
Detected country → matched in your mapping → that currency. No detection or no match → your
default currency. It never leaves a guest without a price.
:::

## What it never touches

* **Logged-in customers:** Always retain their account profile currency without override.
* **Private/Local IPs:** Localhost or private networks (`127.0.0.1`, `192.168.x.x`) cannot be geolocated and use the Default Currency fallback. Always test from a public IP in incognito mode.

## Registration-page auto-switch

On the signup form, the currency follows the visitor: when a guest changes their **country** on
the registration page, the currency updates automatically to match — so the totals they review
before signing up are already in the right currency.

::: warning Requires an active license
Currency localisation requires an active GeoSync Pro license. Background checks run without page delay. If a license lapses, localisation pauses while WHMCS and checkout continue normally.

## Set it up

Configure everything on the [Configuration](/geosync-pro-whmcs/configuration) page, or follow the
step-by-step [Map countries to currencies](/geosync-pro-whmcs/guides/set-up-currency-mapping)
guide. To hide WHMCS's own currency dropdown from guests, see
[Hide the currency switcher](/geosync-pro-whmcs/guides/hide-currency-switcher).