page last edited on 21 February 2018
If you sale worldwide it makes sense to use the addon Multicurrency to make purchases easier for your international customers.
The Multicurrency addon works in a bundle with the addon Geolocation that uses a free “GeoLite2 Country” database by MaxMind.
So please ensure that the addon Geolocation is enabled. The “GeoLite2 Country” database allows to define a customer’s location accurate to a country. If you need higher accuracy, you can upload other databases on the Geolocation addon settings page.
To enable the Multicurrency addon, follow the instructions from Installing and Activating Addons.
Once the addon has been installed, the Multicurrency addon will become available in the Store setup -> Localization section of your store admin area.
Please refer to the Currencies tab to configure the addon settings:
- 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.
- Currency converter API key : Specify your currency converter API key here.
- 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 addon 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.