Multiple currencies in WooCommerce

Multi-currency configuration instructions

The Helcim Commerce for WooCommerce plugin supports multi-currency functionality provided for WooCommerce by their base WooPayments plugin.

In order to configure your WooCommerce for multi-currency, you will need to install the WooPayments plugin and configure the multi-currency. The plugin only needs to be active and does not need to be enabled as a payment option for your store payments. 

Log in to your WordPress account to install and configure the WooPayments plugin and get access to the multi-currency functionality for your store through the Helcim commerce for WooCommerce plugin.

1. Select Plugins > Add New Plugin
2. Search WooPayments and install the plugin

Once installed, you can configure your multi-currency for your WooCommerce.

1. Select WooCommerce > Settings
2. Select Multi-currency
3. Add your additional USD or CAD currency
4. Check the setting to "Automatically switch customers to their local currency if it has been enabled"
5. Save your changes

Once configured, customers who visit your checkout will be toggled to the appropriate currency based on their location.

What currencies can I process in using the Helcim commerce for WooCommerce plugin?

The Helcim commerce plugin for WooCommerce supports a single merchant account and currency for US based merchants. 

Canadian based merchants can modify the plugin in order to support both CAD and USD currencies. Before configuring your account for multi-currency, Canadian based merchants will need to connect with our support team to have the required merchant account and banking information configured for your processing and deposits. To request this, please open a support ticket through your Helcim account located under All Tools, then Support Tickets.

Does the Helcim commerce for WooCommerce plugin support other multi-currency plugins?

Due to the number of available third-party plugins for multi-currency through WooCommerce, we are only able to provide support for multi-currency using the base WooPayments functionality offered by WooCommerce.

Legacy multi-currency configuration instructions

In addition to the above steps, the following modification instructions are only required for merchants using a plugin version below V4.0.1.

How do I modify by code for my legacy Helcim commerce WooCommerce Plugin?

• When setting up the plugin in WooCommerce, enter the CAD Helcim Commerce Terminal Id in your settings.
• Modify the plugin's php file.
  • the file is called (HelcimDirectService.php) and it should be located at: wp-content/plugins/helcim-commerce-for-woocommerce/classes/HelcimDirectService.php depending on your WordPress and WooCommerce installation.
  • The code to modify should be found approximately at line 130. (See Original Code sample below)
  • Modify the php with the new code (see New Code sample below)
  • Enter your USD Helcim Commerce API Terminal Id as part of the php code, where it says "CHANGE_TO_USD_TERMINAL_ID"
• Test a transaction in each currency before going to production.

Original Code

PHPPHPPHP
$helcimArgs['terminalId'] = $wcHelcimGateway->getTerminalId();

New Code

PHPPHPPHP
$helcimArgs['terminalId'] = $wcHelcimGateway->woocommerceCurrencyAbbreviation() === 'CAD' ? $wcHelcimGateway->getTerminalId() : "CHANGE_TO_USD_TERMINAL_ID";