2021 Q4 Sale BFCM – Free Users Sitewide Banner

  1. Documentation
  2. WooCommerce Payments

Multi-Currency with WooCommerce Payments

WooCommerce Payments allow merchants to set up their store to receive payments in one of many currencies, giving the shopper a list of currencies to choose from. The list of currency options can be tailored subject to the store’s registered business location. This document explains the setup, options, the various places where multiple currencies can be used, and frequently asked questions around the multi-currency feature.

Supported Currencies 

The Multi-Currency feature supports all currencies in the WooCommerce Payments accepted currencies list.

Settings ↑ Back to top

The functionality is enabled as part of WooCommerce Payments. You should see the Multi-Currency tab after visiting Payments > Setting.

After clicking on the Multi-Currency tab you should see a screen showing only the store’s default currency, with a button to add more currencies.

This image has an empty alt attribute; its file name is 2LcdccFCjadAjsFe-lWz2xlpLMoRdgPyzJxzHBqmZD7hImOmh0rq_QeyjgDcHpAeG5BrxlEDYDuHilni0v1zLuqUyoQBqa4R3W6BKDWttS468LEJBVWnVIQ_foeKl6pQ22TusPUF

From this screen, you can add all the currencies that you’d like to accept on your store. To add a currency, see the next section.

Adding Customer Currencies ↑ Back to top

After navigating to the settings you will see a button for adding currencies. Clicking the “Add currencies” button will bring up a modal with a list of available currencies that are supported by WooCommerce Payments.

From this list, you can enable currencies that you want to allow your users to view the store prices converted into and selecting the desired currencies before clicking the “Update selected” button.  After clicking this button, you will see a list of the currencies enabled on your store.

By default, the rates are retrieved automatically. Additional details are available in the Rates section. Each currency has its own management screen where you can configure exchange rates and more, for more information about this, please see the manage a currency section.

Exchange Rates ↑ Back to top

Rates are retrieved from the WooCommerce Payments server on a daily basis. You also have the option of setting a manual rate when managing a currency, which will override the automatic rate.

Disclaimer: Exchange rates are not accurate to the minute and may differ from what you’ll find when looking at historical exchange rates. The exchange rates will also vary slightly from the rate used at the time of transaction.

Managing a Customer Currency ↑ Back to top

Clicking on the manage link in a currency row takes you to a new settings screen for that specific customer currency.

Exchange Rate ↑ Back to top

Use the exchange rate setting to choose between a manual and an automated rate. Automatic rate fetching is selected by default. 

Manual rate allows you to specify your own fixed rate of exchange, which will take priority over the automatic rate if it is set.

Formatting rules ↑ Back to top

Formatting rules create consistency in your converted product prices, without having to adjust prices individually on each product. 

Price rounding

Price rounding always rounds the converted price up to the nearest amount selected. For example, if a converted price product price is 5.32, and price rounding is set to 0.50, it will round the converted price up to 5.50. If price rounding is set to 1.00, it will round the converted price up to 6.00, and so on. For decimal currencies, price rounding is set to 1.00 by default. For non-decimal currencies, price rounding is set to 100 by default. 

Price charm

‘Price charming’, also known as ‘psychological pricing’, reduces the converted price by a specific amount.  It is a pricing strategy that reduces the price by either 0.01 or 0.05 as prices slightly less than a whole round number (e.g. $1.99 instead of $2) are perceived as more attractive to a consumer. Price charm is set to None by default. 

Previewing converted prices ↑ Back to top

Enter a hypothetical product price using your store’s default currency to view the amount converted to the customer currency using the selections from the formatting section above. 

Currency Switcher ↑ Back to top

Adding the widget ↑ Back to top

If you would like your customers to be able to choose their currency from the front-end and are not using a theme that supports this by default, you will need to make use of the currency widget. To do this, go to Appearance > Widgets and look for the “Currency Switcher” widget and add it to the best location in your theme.

Widget settings ↑ Back to top

In the widget setting, choose if you want the widget to display currency symbols and flags next to the currency name.

Example widget dropdown ↑ Back to top

Storefront Support ↑ Back to top

If you’re using the Storefront theme or one of the many child themes based on it, the currency widget can be added to the breadcrumbs section.

To enable this, visit the Payments > Settings and then click on the “Multi-Currency” tab at the top. Next scroll down to “Store settings” and check the box next to the setting “Add a currency switcher to Storefront…”. 

Support for other themes ↑ Back to top

Note: This is a Developer level section. If you are unfamiliar with code/templates and resolving potential conflicts, select a WooExpert or Developer for assistance. We are unable to provide support for customizations under our Support Policy.

If you are not using the Storefront theme, or one of the many child themes based on it, you can add the currency switcher into your theme using the next snippet:

<?php 
	if ( function_exists( 'wc_get_currency_switcher_markup' ) ) {
		$instance = [
			'symbol' => true,
			'flag'   => false,
		];
		$args = [];
		echo wc_get_currency_switcher_markup( $instance, $args );

	}
?>

Where $instance array allows you to enable/disable the symbol and flags in the switcher, and $args accepts the same arguments as the_widget to configure the display of the widget.

Analytics ↑ Back to top

All data within analytics will be converted back to the store’s base currency. There should be no changes to the reports or any of the other analytics screens. This means you will not be able to see individual breakdowns of orders made in different currencies. A column has been added to the ‘Orders’ analytics report to show which currency a customer used to complete the order.

Merchant account currency and shopper payments currency ↑ Back to top

When a user selects a different currency than the store’s default currency, the updated prices shown will be based on the exchange rate set in the multi-currency settings. At checkout, a payment intent will be created with currency and the price shown to the customer. The server will take that currency and amount and convert it into the currency of the merchant’s Stripe account.

WooCommerce - the most customizable eCommerce platform for building your online business.

  • 30 day money back guarantee
  • Support teams across the world
  • Safe & Secure online payment