> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.clearpay.co.uk/v-2/woocommerce-1/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.clearpay.co.uk/_mcp/server.

# WooCommerce

WooCommerce is an open-source e-commerce plugin for WordPress.

## Before you begin

Before you start to use Clearpay with WooCommerce, check that:

* You are a merchant in a [supported country](#supported-countries)
* Your WordPress version is 4.8.3 or greater
* Your WooCommerce version is 3.2.6 or greater
* You have set the correct store currency in the general WooCommerce settings. The currency must match your Clearpay account region. Pay special attention to the thousand and decimal separator settings. See the screenshot below:

![](file:docs/assets/images/8c85de2-Screen_Shot_2019-04-15_at_3.21.27_pm.png "Screen Shot 2019-04-15 at 3.21.27 pm.png")

## Install and configure Clearpay

Clearpay uses a WordPress plugin to integrate with WooCommerce. To install and configure the Clearpay plugin, do the following:

1. From the WordPress *Admin* Dashboard click **Plugins** > **Add New**.
2. Search for *Clearpay*.

![](/_fern-img/6e6a0673d2b63c5a0885b9f7afa4d8ada58dc8cebe94cbfa86ac121a1eb0dc34.webp)

3. Find the plugin listed as the *Clearpay Gateway for WooCommerce* and click **Install Now**.

![](/_fern-img/66ba51acc9fe52e95326ef12f8dc022b93fbccbc2a032da1f547873fc1e3b577.webp)

4. Once the installation is complete, click **Activate**.
5. From the WordPress Admin Dashboard click **Plugins** > **Installed Plugins**.
6. Click **Settings** under *Clearpay Gateway for WooCommerce*.

![](/_fern-img/dc0f081488a596d919ec6d6209f0d230dffed5579cc0d04c8a270df69829c9c3.webp)

7. Under *Core Configuration* enter your Merchant ID we (Clearpay) gave to you.

![](/_fern-img/ec50b3b9a6738ce1f27a2dae861d9e8d0cfa80883fba1dc21e246e711c347592.webp)

8. Enter your *Secret Key*  we (Clearpay) gave to you.

![](/_fern-img/8b632480ee7c76bae63122179fa79aa196cc5a112a788c4d3346948f4020f929.webp)

9. Optional: If you are use Express Checkout, click the *Express Checkout* checkbox. Express Checkout is not available for France, Italy, or Spain.
10. Click **Save changes**. The minimum and maximum payment amounts update when the changes have saved successfully.

## Update the plugin

When Clearpay releases new versions of the Clearpay Gateway for WooCommerce plugin, a notification appears in WordPress Admin. To update the Clearpay plugin:

1. From the WordPress Admin Dashboard click **Plugins** > **Installed Plugins**.
2. Find the *Clearpay Gateway for WooCommerce* in the plugin list.
3. Click **Update Now**. When the update is complete, the update bar turns green.

## Supported Countries

\


> **Supported Countries**
>
> Clearpay is available for WooCommerce merchants with a store address in these countries:
>
> 🇬🇧 UK
>
> As Afterpay in these countries:\
> [🇦🇺 Australia](https://developers.afterpay.com/afterpay-online-developer/guides/platforms/woo-commerce/introduction)\
> [🇳🇿 New Zealand](https://developers.afterpay.com/afterpay-online-developer/guides/platforms/woo-commerce/introduction)\
> [🇺🇸 United States](https://developers.cash.app/afterpay/guides/platforms/woo-commerce)\
> [🇨🇦 Canada](https://developers.afterpay.com/afterpay-online-developer/guides/platforms/woo-commerce/introduction)

## Docs

- [Advanced configuration](https://developers.clearpay.co.uk/v-2/advanced-configuration-1.md): 
- [Frequently asked questions](https://developers.clearpay.co.uk/v-2/frequently-asked-questions.md): 
- [Currency Conversion](https://developers.clearpay.co.uk/v-2/currency-conversion.md): 
- [Configure plugin](https://developers.clearpay.co.uk/v-2/woo-comm-configure-plugin.md): How can I add Clearpay as a payment method and display Clearpay Site Messaging?
- [Hooks](https://developers.clearpay.co.uk/v-2/woo-comm-hook.md): This section describes the WordPress hooks used by the Clearpay WooCommerce integration.