> This page is for version v2 (default).
> For other versions, use one of these documentation indexes:
> - v2 (default): https://developers.clearpay.co.uk/v-2/llms.txt
> - v1: https://developers.clearpay.co.uk/v-1/llms.txt

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

# Configure plugin

## Configuration

Complete the steps below to enable and display Clearpay as a Payment Method and add Clearpay messaging to product pages.

> **Note**
>
> If the 'Clearpay Gateway Installation' steps have just been completed, go to Step 3.

1. Go to the *WordPress Admin Dashboard*.
2. Go to *Plugins > Installed Plugins*.
3. Find the *Clearpay Gateway for WooCommerce* in the plugin list and click **Settings**.
4. Go to the *Core Configuration* section.

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

5. Enter the Merchant ID provided by Clearpay into the *Merchant ID* field.

![](/_fern-img/03f176bf4ca8f42ca3eb78b6e255b0fe3cf4d13695ead8c9fa8b916dc27c53e6.webp)

6. Enter the Secret Key provided by Clearpay into the *Secret Key* field.

![](/_fern-img/375ba5b238f2a8174e51824eeb9b7cd25fab59a0b128ebd911b9d6526d70eb27.webp)

7. Click the **Save changes** button at the bottom of the page.

> **Note**
>
> When the Clearpay credentials are saved, the *Minimum Payment Amount* and *Maximum Payment Amount* values are automatically updated.

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

## Enable Express Checkout

1. Go to the *WordPress Admin Dashboard*
2. Go to *Plugins > Installed Plugins*
3. Locate the *Clearpay Gateway for WooCommerce* in the plugin list and click the **Settings** button.
4. Find *Express Checkout Configuration* and enable the *Enable on Cart Page* checkbox.

![](/_fern-img/78d224f077af8358f9b6945dcb5dd81ac1813bbe5ace2d004dc0c14f9ec17c89.webp)

## Enabling the Clearpay Messaging for WooCommerce

The Clearpay messaging can be enabled on:

* Category Pages

* Product Pages

* Cart Page

To start do the following:

1. Login to the Wordpress Dashboard.
2. Go to *Plugins* > *Installed plugins* > *Clearpay Gateway for Woocommerce* and click *Settings*.

Under *Settings*, you can see settings for:

* [Express Checkout Configuration](#enable-express-checkout)

* [Payment Info on Category Pages](#payment-info-on-category-pages)

* [Payment Info on Individual Product Pages](#payment-info-on-individual-product-pages)

* [Payment Info Display for Product Variant](#payment-info-display-for-product-variant)

These settings are described below.

### Payment Info on Category Pages

To enable the messaging on the Category page, do the following:

1. Ensure the *Enable* checkbox is enabled.
2. Enter the correct hook to position the messaging and set the priority to increase or decrease the height of the Messaging position. See the **Hook** section below.

#### Hook

The positioning of the Messaging for Woocommerce relies on a hook. [This link](https://www.businessbloomer.com/woocommerce-visual-hook-guide-archiveshopcat-page/) is a guide to understanding hook positioning on Category pages.

> **Warning**
>
> The hooks for Category pages and Product pages are completely different.

For example, use the hook `woocommerce_after_shop_loop_item`to position the messaging under the price:

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

Below is an example of a category page with Clearpay messaging:

![](/_fern-img/5f37ca290b0e1d261ef4d5754e4577f5b9adbe4f358ad9f212a730e815be2cbb.webp)

> **Note**
>
> For more information on hooks, see the [Hooks](/woo-comm-hook)  page.

### Payment Info on Individual Product Pages

To enable the messaging on the individual Product page, do the following:

1. Ensure the Enable checkbox is enabled.
2. Enter the correct hook to position the messaging and set the priority to increase or decrease the height of the Messaging position. See the **Hook** section below.

#### Hook

The positioning of the Messaging for Woocommerce relies on a hook. [This link](https://www.businessbloomer.com/woocommerce-visual-hook-guide-single-product-page/) is a guide to understanding hook positioning for Product pages.

> **Warning**
>
> The hooks for Product Pages and Category Pages are completely different.

For example, use the hook `woocommerce_before_add_to_cart_form` to position the messaging directly under the Product Page price:

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

Below is an example of a Product Page with Clearpay messaging:

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

> **Note**
>
> For more information on hooks, see the [Hooks](/woo-comm-hook) page.

### Payment Info Display for Product Variant

This option enables the Clearpay Messaging for any variant products.

For example a product that has a price range from £50 - £200. The Clearpay Messaging will also display the instalment breakdown according to a price range.

When a customer selects a variant, a specific price appears. This option enables the Clearpay Messaging to display a specific price breakdown.