page last edited on 21 February 2018
If you sale worldwide it makes sense to use the Multicurrency module to make purchases easier for your international customers.
The Multicurrency module works in bunble with the Geolocation module that uses a free “GeoLite2 Country” database by MaxMind. So, please, check that the Geolocation module is enabled. The “GeoLite2 Country” database allows to define a customer’s location accurate to a country. If you need to improve the accuracy you can upload other databases on the Geolocation module settings page.
To enable the Multicurrency module please follow instructions from Installing and activating addons.
Once installed the Multicurrency module will become available in the Store setup -> Localization section of your store admin area.
Please, refer to the Currencies tab to configure the module settings that are as follows:
- Hide trailing zeros in fractional part : If enabled a price will be displayed without decimals
- Online currency rates service : Choose a currency converter or set to NONE to define the conversion rates manually
- Update online rates every : Set a periodicity of the rates revision
- Add currency (button and drop-down): Choose a currency you want to add in a drop-down and click the ‘Add currency’ button
Each currency comes with a pre-set list of countries it’s applicable to. If you want you can add/remove countries to/from the list by clicking the ‘Countries’ field. Each country can be assigned to one currency only.
If you change the default store currency don’t forget to update the rates using the ‘Update Rates’ button for the prices to be displayed correctly.
When installed and configured the module in action will look as follows in the store front-end:
A customer will see the currency and the language of the country his IP belongs to. A language switch will be available only if translations are enabled in the store. If there are no particular currency and translation defined for the customers location the store content will be displayed in the default currency and language.
The currency that will be used for orders processing will depend on the payment gateway you are using. Some payments allow orders processing only in the default store currency. Others allow to accept payments in more than one currency. Please, check with your payment processing company for details.
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.