Currency Conversion

Version 3.5.0 and later versions of the Afterpay plugin for WooCommerce support currency conversion. This is a great feature for merchants who operate in multiple countries with multiple currencies.


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


To implement the currency convertor, do the following:

  1. Open WordPress admin and navigate to WooCommerce.

  2. Click Settings, and then click the Payments tab. The Afterpay Gateway information appears.

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

Enable/Disable - Enable Afterpay is checked.

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

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

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

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

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

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

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

Merchant Country - This must be the country where your Afterpay 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.

  1. 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 Afterpay with their local currency selected and pay the exact amount that they see in checkout.

With Enable Multicurrency disabled, Afterpay is not available when a foreign currency is selected. However, overseas customers may still be able to log into their local Afterpay/Clearpay customer account to complete the order, and pay in their local currency. This method uses Afterpay 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 - Afterpay 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.

  1. 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 USA and the customer wants to pay with US dollars. The prices for the items are in US dollars.


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