> This page is for version v1.
> 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.

# Frequently Asked Questions (FAQs)

## Q: Why was a customer returned to the Shopify checkout page after trying to place an order with Clearpay?

A: There are two common causes for a customer being returned to the Shopify checkout page after trying to place an order with Clearpay. These causes are listed below:

1. Invalid order amount.\
   A customer’s Clearpay transaction will not be approved should the order total be:

* Below the merchant minimum order value.
* Above the merchant maximum order value.
* In a non-supported currency.\
  As such, the customer will be returned to the Shopify checkout page.

2. Incorrect merchant credential configuration.\
   The communication between Shopify and Clearpay is dependent on a correct combination of the Merchant ID and Secret Key.\
   Please ensure that:

* Merchant ID is entered correctly.
* Secret Key is entered correctly.
* Test Mode is not enabled.\
  *See [Clearpay Payment Gateway](/v-1/shopify-clearpay-gateway-configuration) for additional information.*

## Q: Why did Clearpay disappear from the Shopify product page after changing themes?

A: To display the Clearpay instalment detail on the Shopify product pages, the active store theme is modified. When changing Shopify theme, a new set of theme/template files will be installed, which will not include the Clearpay product page display.

Although the product page display will require re-integration, Clearpay will remain active as a Payment Method on the Shopify checkout page.

To re-integrate the Clearpay product page display for the newly installed Shopify theme, please complete the steps outlined in the [Clearpay Product Page Display](/v-1/shopify-clearpay-product-page-display) section.