WHMCS Addon Module · v0.0.1

Every visitor sees the right currency, automatically.

GeoSync Pro detects each WHMCS visitor's country via IP geolocation and switches the storefront to the matching currency — instantly, before they even reach the pricing page. One simple rule covers all 27 EU countries.

WHMCS 8.x compatible 27 EU countries in one rule HMAC-secured integrity One-click auto-updates
Live currency routing
Detecting visitor country → matching WHMCS currency
GEOSYNC PRO
World map showing per-country currency detection — USD, EUR, INR, JPY, AUD
🇺🇸$ USD
🇪🇺€ EUR27 countries
🇮🇳₹ INR
🇯🇵¥ JPY
🇦🇺A$ AUD
Auto-detection live — 5 currency routes active
via ip-api.com · 1-hour session cache
27EU countries
One rule covers all
IPCountry detection
via ip-api.com
HMACSHA-256 integrity
Tamper detection
1-clickAuto-updates
Backup & restore
PHP 7.4+WHMCS 8.x
ionCube ready
Pricing

Simple, transparent licensing

One license per WHMCS installation. Includes updates, support, and unlimited visitor detections.

Leased License

Yearly plan with continuous updates

$1.56/mo
Billed Annually. Renews at $18.77/year.
  • One WHMCS installation
  • All features included
  • One-click auto-updates
  • Email & ticket support
Choose Monthly
* Prices are exclusive of GST. 18% GST applicable on Indian invoices.  ·  Need multiple installations? Contact us for volume pricing.
Built for global WHMCS storefronts

Everything you need to show the right currency

From the first page load to the file integrity report — automated, secure, and admin-friendly.

IP-based auto-detection

Detects each visitor's country via ip-api.com with a 1-hour session cache. Falls back to your configured default whenever detection isn't possible.

Country-to-currency mapping

Map any ISO 3166-1 alpha-2 country code to a WHMCS currency. Use the single EU rule to cover all 27 EU member states at once.

Registration auto-switch

Currency updates live as visitors change their country on the WHMCS registration form — no page reload, no friction.

Logged-in user protection

Existing clients always see their profile currency. Auto-switching is strictly guest-only — no surprises mid-checkout for paying customers.

HMAC-SHA256 file integrity

Every addon file is checksummed with HMAC-signed SHA-256. Tamper detection runs at both filesystem and database levels, with auto-sync on every admin load.

One-click auto-update

Daily update checks, one-click apply, automatic backup before every update, auto-restore on failure. Stay current without leaving the admin panel.

Currency Configuration

One mapping table. Every country covered.

Set your default currency, then map specific countries with two-letter ISO codes. Use the special EU rule to handle all 27 EU member states with a single line — no need to maintain a list.

  • ISO 3166-1 alpha-2 country codes (IN, GB, JP…)
  • One EU rule = 27 countries → one currency
  • Maps only to currencies active in WHMCS
  • Configurable default fallback for unmapped regions
addons / geosync_pro / currency
Currency Localisation
Enabled
Default · INR (₹)
Country → Currency mappings
CountryCodeCurrencyCoverage
🇮🇳 IndiaININR1 country
🇪🇺 European UnionEUEUR27 countries
🇬🇧 United KingdomGBGBP1 country
🇺🇸 United StatesUSUSD1 country
🇯🇵 JapanJPJPY1 country
🇦🇺 AustraliaAUAUD1 country
Add Mapping
Visitor Experience

Currency switches the moment the visitor's country does.

On the registration form, the currency dropdown follows the country dropdown — instantly, with no page reload. Combined with IP-based detection on landing, most visitors never have to think about currency at all.

  • IP-based detection on every guest page load
  • Live JS auto-switch when country changes on signup
  • Optional: hide currency selector for guests entirely
  • Logged-in users keep their profile currency, untouched
acmehosting.com / register.php
Create your account
Country
🇩🇪 Germany
Currency↻ AUTO-SWITCHED
EUR · Euro
Selected plan — Pro Hosting
Annual billing€ 89.00/year
↑ Was ₹8,988 before country selection — switched without a page reload.
Security & Integrity

HMAC-signed. Tamper-evident. Self-healing.

Every addon file and hook stub is checksummed with SHA-256, then signed with HMAC using ionCube-protected keys. The plugin verifies its own files on every admin page load — and auto-syncs the baseline when changes are detected.

  • HMAC-SHA256 checksums across files and database
  • Continuous integrity verification on every admin load
  • Auto-backup before every update, auto-restore on failure
  • Full sync history — every manual & auto-sync logged
integrity verification — 24 files tracked
geosync_pro.php✓ verified
lib/Core/SyncManager.php✓ verified
lib/Services/GeoIPService.php✓ verified
lib/Database/ChecksumStore.php✓ verified
hooks.php✓ verified
HMAC valid · Last snapshot: 24-May-2026 14:08 IST
Compatibility

Requirements & compatibility

GeoSync Pro runs on any standard WHMCS environment. No exotic dependencies, no server-level changes required.

System Requirements

WHMCS Version8.x or later
PHP Version7.4 or higher
ionCube LoaderRequired
DatabaseMySQL / MariaDB
Disk Space~ 3 MB

PHP Extensions & Templates

curl✓ required
json✓ required
zip✓ required
TemplatesSix · Twenty-One · Nexus
Third-party templatesCompatible (see FAQ)
All requirements are standard on any modern cPanel / WHMCS-ready host — including all Relyweb hosting plans.
FAQ

Common questions

Can't find what you're looking for? Get in touch.

What does GeoSync Pro actually do?

GeoSync Pro is a WHMCS addon that automatically shows each visitor the right currency based on where they're browsing from. It detects the visitor's country via IP geolocation, looks up your country-to-currency mapping, and sets the WHMCS session currency accordingly — all before the visitor sees a price.

On the registration page, it also updates the currency live as the visitor changes their country in the form. Logged-in users always keep their profile currency, untouched.

How does the country detection work?

GeoSync Pro uses ip-api.com to resolve the visitor's IP address to a country. The result is cached in the visitor's session for 1 hour, so subsequent page loads don't trigger additional lookups. This keeps the storefront fast and avoids hitting rate limits.

Private and local IPs (127.0.0.1, 192.168.x.x, etc.) can't be geolocated — these visitors fall back to your default currency.

Do I really need just one rule for all 27 EU countries?

Yes — that's the whole point of the EU rule. Instead of maintaining 27 separate mappings (Austria → EUR, Belgium → EUR, Bulgaria → EUR, and so on), you write a single line: EU → EUR. GeoSync Pro recognises all 27 EU member states and applies the mapping to any visitor from those countries.

You can still add country-specific overrides if you ever need to — for example, an FR → USD rule would take precedence over the EU group for French visitors.

What happens to logged-in customers who travel?

Nothing. Logged-in users always see the currency stored on their WHMCS profile — GeoSync Pro never overrides it based on their current IP. This is deliberate: a paying customer in Mumbai who happens to log in from a coffee shop in Bangkok should still see ₹ pricing, not ฿ pricing.

Auto-detection only runs for non-logged-in visitors browsing the storefront.

What if IP detection fails, or the visitor uses a VPN?

You configure a default currency in the admin panel — this is what visitors see whenever country detection isn't possible (failed lookup, private IP, unmapped country). For VPN users, the detected country will simply match the VPN endpoint; GeoSync Pro applies the mapping just as it would for any other visitor.

Will it work with my third-party WHMCS template (Lagom, etc.)?

Yes for the core currency-switching functionality — currency detection and session updates work regardless of template. The "Hide Currency Switcher" feature, however, ships with CSS rules for the built-in Six, Twenty-One, and Nexus templates only.

If you use a third-party template like Lagom, you may need to disable the currency dropdown from your theme's own settings. The plugin will show a warning in the admin panel when a third-party template is detected.

How does file integrity verification work?

On activation, GeoSync Pro takes a SHA-256 checksum of every addon file and the hook stub, then stores those checksums in the database with HMAC signatures using ionCube-protected keys. On every admin page load, the plugin re-checks the files against the stored baseline — if anything was modified outside of an official update, it flags the change in the sync status panel.

Auto-sync runs the same check and, when changes are legitimate (e.g., after a manual update), refreshes the baseline. Every sync — manual or automatic — is logged.

How do plugin updates work?

GeoSync Pro checks for updates once a day via the WHMCS cron, so the admin panel always shows the latest version. You can also click Check for Updates manually at any time. When an update is available, click Update Now — the plugin downloads the release zip, backs up the current installation, extracts the new version, runs the integrity sync, and reloads. All in one click.

If anything fails mid-update, GeoSync Pro automatically restores from the backup so you're never left in a broken state.

Can I get a refund if it doesn't work for me?

Yes — we offer a 14-day money-back guarantee. If GeoSync Pro doesn't work for your setup or doesn't meet your needs, just contact support within 14 days of purchase for a full refund. All licenses include email and ticket support; Lifetime licenses get priority response. Our team is based in Ahmedabad and we reply in English and Hindi.

Stop guessing where your visitors are. Start showing them the right price.

Drop in GeoSync Pro and your storefront speaks every visitor's currency — in minutes, with a 14-day money-back guarantee.