> 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. # PrestaShop PrestaShop is an open source eCommerce platform that works on the PHP scripting language. Clearpay has a module that can be installed in the back office admin area for PrestaShop. ## Before you begin Before you install the Clearpay module: * Ensure that you have a Clearpay account, you can sign up here [UK](https://get.clearpay.co.uk) * Check your PrestaShop version. The Clearpay module is only compatible with versions 8, 1.7.x and 1.6.x ## Installing and configuring the Clearpay module 1. In the PrestaShop admin panel, navigate to *Modules* > *Module Catalog*. 2. Search for *Clearpay* and click **Install**. ![](file:docs/assets/images/fc1fd60-a8b913e-Captura_de_pantalla_2021-03-10_a_las_19.53.00.png "a8b913e-Captura_de_pantalla_2021-03-10_a_las_19.53.00.png") 3. Click **Configure**. The Clearpay configuration panel appears. 4. Enter your Clearpay merchant ID and secret key. 5. Ensure the *Module is enabled* field is toggled to *Yes*. 6. Set the API environment dropdown to *Production*. 7. Click **Save**. Check whether the module has been installed and configured correctly, check that the Clearpay option is displayed on your product pages and at checkout. | Setting | Value | | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Module is enabled | **Yes** - Clearpay turned on **No** - Clearpay disabled. | | Merchant ID | Your 9 digit Clearpay Merchant ID. | | Secret Key | Your 128 character Clearpay secret key. | | API Environment | **Sandbox** **Production** | | Min Payment Limit/Max Payment Limit | Current minimum and maximum Clearpay order thresholds. **These values are for information purposes and cannot be customised in Prestashop.** | | Enable Multicurrency | Enable multicurrency support. | | CBT Countries | Cross Border Trade (CBT) allows you to sell internationally, with consumers in foreign countries paying in their local currencies, while Clearpay continues to settle with you in your local currency. This information is supplied by Clearpay and cannot be edited. **This value is for information purposes and cannot be customised in Prestashop.** | | Payment Limits | CBT payment limits. **This value is for information purposes and cannot be customised in Prestashop.** | | Restricted Categories | This enables the merchant to restrict Clearpay to the selected product categories. | | Payment Info on Individual Product Page | Enable to display Clearpay elements on individual product pages. | | Product Page HOOK | This property sets the HOOK where Clearpay messaging is linked on the product page. Only change this value if the messaging doesn't appear correctly. | | Price CSS Selector | This property sets the CSS selector needed to show the assets on the product page. Only change this value if the assets do not appear correctly. | | Product Page CSS Position Selector | Clearpay messaging is moved after the CSS Selector DOM Element. Only change this value if the messaging doesn't appear clearly. | | Payment Info on Cart Page | Enable to display Clearpay elements on the cart page (available for PS 1.7 and higher). | | Cart Page CSS Selector | This property sets the CSS selector needed to show the assets on the cart page. Only change this value if the assets do not appear clearly. | | Canonical URLs | Only enable this option if the checkout doesn't redirect clearly to the payment gateway and shows a 404 error. | | Debug mode | Enable the debug logging. You can see these logs on the *Configure* > *Advanced Parameters* > *Logs* section. | | Enable Reversal | If Prestashop throws an exception while attempting to finalise an order after payment is approved by Clearpay, the payment can be reversed automatically. This may help to prevent scenarios where customers pay for orders that cannot be fulfilled. Not recommended if an external Order Management System (OMS) is in use. | \ ## FAQ #### Why does an Unauthorised error message appear when I try to save the configuration? ![](/_fern-img/932f564729fcdeab8418a1c31b28f82e86cdc9db4e183242e3aa411692a78e7b.webp) There are two common causes for this error message: **Incorrect merchant credential configuration** Make sure that you enter the Merchant ID and Secret Key correctly. Do not have blank spaces either before or after these codes. **The Environment is set to *Sandbox* instead of *Production*** Make sure that you select the *Production* API environment in the *Settings* menu. #### Can I prevent Clearpay being available for specific products? If you have categories that do not comply with the Clearpay standards for authorized products, you must mark them as restricted on the admin panel configuration. Those categories selected as *restricted* will prevent Clearpay being available on the: **Product Page** - If the product belongs to a restricted category, the Clearpay widget is not present on the product page. **Cart Page** - If some of the products in the cart belong to a restricted category, the Clearpay widget is not present on the cart page. **Checkout page** - If some of the products in the checkout belong to a restricted category, Clearpay does not appear on the checkout page as a payment option. ## Updating the Clearpay/PrestaShop Module Clearpay periodically updates its module. There are two ways to ensure your module is up-to-date: * [Use the PrestaShop Marketplace](#use-the-prestashop-marketplace) * [Use the Module Manager updating tool](#use-the-module-manager-updating-tool) > **Note** > > We strongly recommend that you always use the latest version of the Clearpay module. ### Use the PrestaShop Marketplace When a new version of the Clearpay module is released on the PrestaShop Marketplace, the PrestaShop store should detect the new version. The PrestaShop store automatically shows the upgrade option. To upgrade, to the following: 1. Go to the *Module Manager* section on the left menu bar. See the picture below: ![](/_fern-img/76797d70de8e944ef48ecb4a9bd652339d63647a4713249a1ff1ffdf8113c9a1.webp) 2. Use the search bar to find the Clearpay installed module and click **Upgrade available**. 3. A confirmation window appears, see the picture below: ![](/_fern-img/9cd9f309385d664b08b7e9f3f50ee536ac092b161c4a5a90076060f1704ba986.webp) 3. Ensure you have a backup of the site before any upgrade. Click **Go to maintenance page** to avoid possible cache issues. Click **Upgrade Anyway** if you have a backup of the site and are confident you can problem solve if necessary. When the upgrade is finished you receive a confirmation message. The **Actions** button shows the regular options. > **Note** > > Open the Clearpay configuration *Settings* section to check that all the configurations are correct after the upgrade. See the picture below: ![](/_fern-img/958b2b4817ec49d2a73fe5864efe8229b7e9a22dbf5a63e383f01f4321e2d774.webp) ### Use the Module Manager Updating Tool This is a manual update procedure you can use if you have disabled the upgrade option on your store. Do the following: 1. Go to the Module Manager Admin panel. 2. Go to the *Prestashop Addons Marketplace* and download the upgrade you want. We strongly recommend that you always have the latest version of the code. 3. To [download the files](https://addons.prestashop.com/en/payment-card-wallet/50492-clearpay-buy-now-pay-later-always-interest-free.html) you must be logged into your PrestaShop account. 4. Open the *Module Manager* section and click **Upload a module**. 5. Select the previously downloaded file from your computer and upload it. See the pictures below: ![](/_fern-img/6b7a22a914eab5e7b7a980d394d0038e3195241580ce42de1c2f8759d92c40aa.webp) 6. A confirmation message appears when the module is installed.