> 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.

# Update Extension

The Clearpay extension update method depends on how you, the merchant, have originally installed the Clearpay module.

If you used [Composer](https://getcomposer.org/) to install the Clearpay module, then use Composer to update it. If you used a manual process to install the Clearpay module, then use a [manual update](#manual-update) to update it.

The Clearpay extension update process depends on whether you want to use [Composer](https://getcomposer.org/) to make the update, or do a [manual update](#manual-update). We recommend that you [update with Composer](#update-with-composer).

In either case, backup your system files before you start an update.

## Update with Composer

> **Note**
>
> In the instructions below, the `[ADOBE-COMMERCE]` folder refers to the root folder where Adobe Commerce/Magento is installed.

1. Open the Command Line Interface (CLI) and go to the `[ADOBE-COMMERCE]` folder on your server.

2. Run one of the following commands in the table to update the Clearpay module, depending on the Magento version:

| Magento version | Command to run                                      |
| --------------- | --------------------------------------------------- |
| 2.4             | composer require clearpay-global/module-clearpay:^5 |
| 2.3             | composer require clearpay-global/module-clearpay:^4 |
| \< 2.3.0        | composer require clearpay-global/module-clearpay:^4 |

3. Make sure that Composer finishes the installation without errors.

4. Run the Adobe Commerce setup upgrade: `php bin/magento setup:upgrade`.

5. Run the Adobe Commerce Dependencies Injection Compile: `php bin/magento setup:di:compile`.

6. Run the Adobe Commerce Static Content deployment: `php bin/magento setup:static-content:deploy`.

7. Run the Adobe Commerce System Cache Flush: `php bin/magento cache:flush`.

\


## Manual Update

This method does not use Composer. It is more complex than using Composer, but just as effective when done correctly. Follow the instructions below.

### Remove old Clearpay files/folders

> **Note**
>
> In the instructions below, the `[ADOBE-COMMERCE]` folder refers to the root folder where Adobe Commerce/Magento is installed.

1. Remove all the files in: `[ADOBE-COMMERCE]/app/code/Clearpay/Clearpay`. Then you are ready to download the Clearpay Extension.

### Download the Clearpay Extension

The extension is on GitHub. Do the following:

1. Go to GitHub for the link to [Magento 2](https://github.com/clearpayeu/clearpay-magento-2). The source code needed depends on your version of Magento. For these details, scroll down to the bottom of the GitHub table and see the Readme file called Clearpay for Magento 2.

2. Under the green *\<> Code* heading, click **Download ZIP**. See screenshot below:

![adobe-comm-manual-install.png](/_fern-img/42d54ce0ed709651bfe72995fd848a06da105c3094eb4b57ab49a9c73a66b3ab.webp)

3. Unzip your files and put them into a temporary folder.

> **Install Folder**
>
> You can install Adobe Commerce in any folder on your server. In this guide, `[ADOBE-COMMERCE]` is the name of the root folder where Adobe Commerce is installed.

### Run the Commands

1. Copy the files from your temporary folder to the `[ADOBE-COMMERCE]/app/code/Clearpay/Clearpay` folder. The temporary folder is the one you created in Step 3 in the *Download the Clearpay Extension* section above.

2. Open the Command Line Interface (CLI) and make sure you are the owner of the `[ADOBE-COMMERCE]` folder. Run all CLI commands as the owner of the folder, not `root` and without `sudo`.

3. From the CLI, run the commands below:

| Command                                         | Description                                    |
| :---------------------------------------------- | :--------------------------------------------- |
| php bin/magento module:enable Clearpay_Clearpay | Enable Clearpay extension.                     |
| php bin/magento setup:upgrade                   | Adobe Commerce setup upgrade.                  |
| php bin/magento setup:di:compile                | Adobe Commerce dependencies injection compile. |
| php bin/magento setup:static-content:deploy     | Adobe Commerce static content deployment.      |
| php bin/magento cache:flush                     | Adobe Commerce system cache flush.             |

You can find a table of the Clearpay Plugins for Adobe Commerce/Magento 2 [here](https://github.com/clearpayeu/clearpay-magento-2). It also contains useful information on the manual installation process.