Currency Conversion

The Clearpay plugin for WooCommerce supports currency conversion. This is a great feature for merchants who operate in multiple countries with multiple currencies.

Prerequisites

Before you implement currency conversion, check that:

You are a merchant enabled for Cross-Border-Trade (CBT) to other countries
You have a third-party currency conversion plugin. This plugin sends the customer’s selected currency to payment gateways

Implementation

To implement the currency convertor, do the following:

Open WordPress admin and navigate to WooCommerce.
Click Settings, and then click the Payments tab. The Clearpay Gateway information appears.

Scroll down the page and ensure that these fields contain the correct information:

Enable/Disable - Enable Clearpay is checked.

Title - This is what appears as the payment method title on your checkout page. Clearpay is a good default title.

API Environment - Select Sandbox for testing or Production for actual use with real customers and real money.

Merchant ID - Clearpay gives you the merchant IDs for both Sandbox testing and production use.

Secret Key - Clearpay gives you the secret keys for both Sandbox testing and production use.

Minimum Payment Amount - This is set in your Clearpay merchant account.

Maximum Payment Amount - This is set in your Clearpay merchant account.

Settlement Currency - This is set in your Clearpay merchant account.

Merchant Country - This must be the country where your Clearpay merchant account is located.

Excluded Categories - Enter any excluded categories of product or service here and separate each category with a comma. For example, pornography, gambling, firearms.

The next section is entitled Cross Border Trade Configuration. This section controls the currency conversion.

Scroll down the page and ensure that these fields contain the correct information:

Enable Multicurrency - With this enabled, overseas customers are now able to use Clearpay with their local currency selected and pay the exact amount that they see in checkout.

With Enable Multicurrency disabled, Clearpay is not available when a foreign currency is selected. However, overseas customers may still be able to log into their local Clearpay customer account to complete the order, and pay in their local currency. This method uses Clearpay exchange rates (mostly likely different from the rates used on the merchant site). This has always been the default behaviour for cross border trade (CBT) before this multicurrency feature was introduced.

CBT Countries - Clearpay populates this field, which is a list of countries that have been enabled for CBT. After payment, the currency is converted to your currency for settlement.

CBT Limits - This field shows the exchange rates used. These rates are automatically checked every 15 minutes and updated then.

The other fields on this page are not relevant to currency conversion. Scroll down to the bottom of the page and click Save Changes.

The Store Page

Assuming you, the merchant, have applied the correct settings, your store page should behave like this:

When the customer pays in your local currency, the prices are displayed in your local currency
When the customer selects their local currency, the prices change to their local currency

See the screenshots below for an example:

In the screenshot above, the store is based in the UK and the customer wants to pay with British pounds. The prices for the items are in British pounds.

In the screenshot above, the customer wants to pay in US dollars. The customer clicks the USD button on the right side of the page. The prices automatically change from British pounds to US dollars.