# WHMCS Multi-Currency Setup

> Prices, invoices and payments in your customers' currencies, with rates, rounding and gateways set up correctly.

WHMCS multi-currency setup: currencies and formats, ECB rate automation, per-currency pricing, gateway mapping, location-based currency for guests and client moves.

- **Price:** Starting at $149
- **Billing:** One-time, fixed scope
- **Category:** WHMCS
- **Quote turnaround:** Fixed-price quote within 24 hours
- **Start a project:** https://whmcspilot.com/start-project
- **Details:** https://whmcspilot.com/services/whmcs-multi-currency
- **Last updated:** 2026-11-05

## Overview

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](/services/whmcs-tax-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 &gt; System Settings &gt; 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

ScopePriceUp to three currencies with rates, formats, catalog pricing, automation and gateway mappingFrom $149, one-timeAdditional currencies or catalogs with many products and addonsFixed quoteLocation-based currency for guestsFixed quoteMoving existing clients to another currencyFixed 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](/services/whmcs-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](/services/whmcs-multi-language). List your currencies and gateways on the [project form](/start-project) to get a fixed price.

## What's included

- Currencies configured with ISO code, prefix, suffix, format and base rate
- Daily ECB exchange rate updates through Automation Settings
- Prices per currency for products, configurable options, addons, setup fees and TLDs
- Bulk Pricing Updater runs for existing services where needed
- Gateways matched to the currencies they accept, with Convert To For Processing
- Currency-specific cart links for landing pages and ads
- Optional hook that sets the currency for guests from their country
- Existing clients moved to a new currency the way WHMCS documents
- Test orders in every currency through every gateway

## Business outcomes

- Buyers see a price in money they understand before they reach checkout
- Local prices can be set deliberately instead of landing on odd conversions
- Every gateway receives an amount in a currency it can process
- Renewal invoices stay in the currency each client signed up with
- Rates update daily without anyone remembering to do it

## Frequently asked questions

### Can WHMCS update exchange rates automatically?

Yes. WHMCS pulls rates from the ECB daily when Exchange Rates is enabled in Automation Settings. Currencies outside its supported list need a rate entered by hand.

### Do existing customers' prices change when rates change?

No. Automatic product price updates apply to new orders only. Existing services keep their recurring amount unless you run the Bulk Pricing Updater.

### Can WHMCS show each visitor their local currency automatically?

Not by default. We add a hook that sets the currency for guests from their country; registered clients keep the currency on their account.

### Can I change a client's currency after they have invoices?

WHMCS advises against editing it directly. The safe route is a new client account in the new currency, linked to the same user, with each service moved and recalculated.

### What if my payment gateway only accepts one currency?

Set Convert To For Processing on that gateway, and WHMCS converts the invoice amount to the gateway's currency before sending the customer to pay.

### How do I pay for multi-currency setup?

A 50% deposit opens the project and the remainder is due on delivery. Pay through Stripe, PayPal or NOWPayments if you prefer crypto.
