Skip to content

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 adminAddons → 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.

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.

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 page, or follow the step-by-step Map countries to currencies guide. To hide WHMCS's own currency dropdown from guests, see Hide the currency switcher.

Documentation for the Relyweb app catalogue.