WHMCS multi-currency setup lets customers see prices, receive invoices and pay in their own currency, with exchange rates, rounding and payment gateways configured so the numbers add up. Typical buyers are hosting, VPS and IPTV sellers with customers in Europe, the UK, India or elsewhere who are tired of quoting in dollars and explaining the conversion. Configuring up to three currencies starts at $149, one-time. Charging the right VAT, GST or sales tax by country is a separate job, tax and VAT setup; most international sellers need both.
Decisions to make first
The first choice is your base currency, the one every rate is measured against. WHMCS lets you change the default currency only while the install has no invoices or transactions, so on a live site the base usually stays put. The second choice matters more for sales: do prices in other currencies follow the exchange rate every day, or do you set clean local prices such as €9.99 and £8.49 by hand? Rate-driven prices are less work but land on odd figures. Fixed local prices look deliberate but need a review when rates move a lot. Many providers fix prices for their main plans and let rates drive the long tail of addons.
What we configure
- Each currency under Configuration > System Settings > Currencies: ISO code, prefix, suffix, format and base conversion rate. Currencies without decimals, such as JPY, KRW or HUF, need the 1,234 format
- Daily rate updates from the ECB feed under Currency Auto Update Settings in Automation Settings, with Exchange Rates and Product Prices switched on or off to match your pricing decision; currencies the feed does not cover get a manual rate and a reminder to review it
- Prices per currency on every product, configurable option, addon and setup fee, plus domain pricing per TLD
- Bulk Pricing Updater runs where existing services should move to new prices, since automatic updates only affect new orders
- Gateway checks: each gateway shown only for currencies it accepts, and Convert To For Processing set where a gateway takes a single currency
- Currency links such as cart.php?currency=2 for landing pages and ads aimed at one market
Showing the right currency to each visitor
WHMCS does not pick a currency from the visitor's location by itself. Guests see the default and can switch; once someone registers, the currency is stored on their account. We can add a hook that sets the currency for guests from their country, using Cloudflare's country header when your site is behind Cloudflare or a GeoIP lookup otherwise. Logged-in clients are never switched, because their invoices and services are already in a currency.
Customers already in the wrong currency
Changing an existing client's currency on the Profile tab while they have invoices is something WHMCS itself warns against. The documented route is to create a new client in the right currency, link it to the same user, then move each service and domain with Recalculate on Save switched on. We do that in batches, check the first renewal invoice for each moved client, and keep a list of every move.
Version notes
Currency settings look and work the same on 8.13, supported on PHP 8.1 onward, and on 9.x, which requires PHP 8.2 onward; the 9.0 release notes list no currency changes, so a setup done today carries over an upgrade.
What we need from you
- The currencies you want and your base currency
- Your pricing decision per product line: fixed local prices or rate-driven
- A list of gateways and the currencies each of your merchant accounts settles in
- Admin access; file access only if the location hook is part of the quote
Deliverables
- Currencies, rates and automation configured on your live install
- A price sheet export showing every product and addon in every currency, for your sign-off
- Test orders in each currency through each gateway, paid in sandbox where the gateway offers one
- A note on when to review manual rates and fixed prices
Pricing
| Scope | Price |
|---|---|
| Up to three currencies with rates, formats, catalog pricing, automation and gateway mapping | From $149, one-time |
| Additional currencies or catalogs with many products and addons | Fixed quote |
| Location-based currency for guests | Fixed quote |
| Moving existing clients to another currency | Fixed quote per batch |
A standard three-currency setup is normally finished in two to four business days after you sign off the price sheet. The quote is paid 50% before we start and 50% at delivery; currency errors within scope that turn up in the first 14 days are corrected for free.
Not included
- Tax rules and VAT number validation
- New gateway modules for processors WHMCS does not support, which is payment gateway integration
- Merchant account applications and currency settlement with your bank
- Exchange rate or pricing advice
Selling in a new currency often means a new language too, covered by multi-language setup. List your currencies and gateways on the project form to get a fixed price.