# Install the Revolut Gateway for Adobe Commerce (Magento 2)

Learn how to install, upgrade, and uninstall the **Revolut Gateway for Adobe Commerce (Magento 2)**.

## Install the plugin

There are two ways to install the **Revolut Gateway for Adobe Commerce (Magento 2)** plugin, depending on your preferred method.

- ![Install via Marketplace (recommended)]

  ### Install via Adobe Commerce Marketplace

  Complete the following steps to install the plugin via Adobe Commerce Marketplace:
  1. Place an order for the plugin on the [Adobe Marketplace](https://commercemarketplace.adobe.com/revolut-module-payment.html).

      ![Adobe Commerce - Marketplace: Revolut Gateway](/img/accept-payments/plugins/magento/plugins-magento-marketplace.png 'Adobe Commerce - Revolut Gateway')

  1. Open a terminal in your Adobe Commerce project's root folder and run the following command:

      ```shell
      $ composer require revolut/module-payment
      ```

      - If prompted, follow the instructions of Composer.
      - You might need to submit your user credentials and provide your [Adobe Commerce authentication keys](https://experienceleague.adobe.com/docs/commerce-operations/installation-guide/prerequisites/authentication-keys.html).

  1. To enable the plugin on your store, run the following command:

      ```shell
      $ php bin/magento module:enable Revolut_Payment
      ```

  1. To finish the installation, check for updates and compile files, run the following commands:

      ```shell
      $ php bin/magento setup:upgrade
      $ php bin/magento setup:di:compile
      $ php bin/magento setup:static-content:deploy
      ```

  1. When the installation is done, flush the cache with the following command:

      ```shell
      $ php bin/magento cache:flush
      ```

  1. **Log in** to your Adobe Commerce admin panel and navigate to **Stores > Configuration > Sales > Payment Methods**. You should see **Revolut** under **Other payment methods**.

- ![Manual installation]

  ### Manual installation

  1. Download the latest [Revolut Gateway for Adobe Commerce (Magento 2) `.zip` file](https://raw.githubusercontent.com/revolut-engineering/revolut-magento2-releases/master/revolutgatewayformagento2-latest.zip).
  1. Locate the `/app/code` directory inside the root directory.

      :::info
      You might need to create it yourself.
      :::

  1. Extract the plugin in `.zip` format that you downloaded in the `/app/code` directory.

      ```shell
      $ unzip revolutgatewayformagento2-latest.zip
      ```

  1. Open a terminal in the `magento2` root folder and run the commands in the provided code block to install the plugin.

      ```shell
      $ php bin/magento setup:upgrade
      $ php bin/magento setup:di:compile
      $ php bin/magento setup:static-content:deploy
      ```

  1. When the installation is done, flush the cache using the admin panel or the following terminal command.

      ```shell
      $ php bin/magento cache:flush
      ```

  1. **Log in** to your store's admin panel and navigate to **Stores > Configuration > Sales > Payment Methods**. You should see **Revolut** under **Other payment methods**.

:::tip
**Congratulations!** You have installed the **Revolut Gateway for Adobe Commerce (Magento 2)** plugin. You are almost ready to start accepting payments.

To complete the setup and begin processing transactions, [configure the plugin](/docs/guides/merchant/accept-payments/no-code/plugins/magento/configuration).
:::

## Upgrade the plugin

To keep your **Revolut Gateway for Adobe Commerce (Magento 2)** plugin up to date and benefit from the latest features and security updates, you should regularly check for updates.

- ![Upgrade via Composer (recommended)]

  ### Upgrade via Composer
  1. **Log in** to your Adobe Commerce server via SSH and navigate to your Adobe Commerce project's root directory.
  1. Run the following command to update the plugin:

      ```shell
      $ composer update revolut/module-payment
      ```

  1. Follow steps 5 to 9 from the [installation via Marketplace](#install-via-adobe-commerce-marketplace) to complete the upgrade process.

- ![Manual upgrade]

  ### Manual upgrade
  1. Download the latest version of the plugin from the [Revolut GitHub repository](https://raw.githubusercontent.com/revolut-engineering/revolut-magento2-releases/master/revolutgatewayformagento2-latest.zip).
  1. Replace the existing Revolut folder in app/code/ with the new one from the downloaded package.
  1. Follow steps 5 to 9 from the [manual installation](#manual-installation) to complete the upgrade process.

:::info
Upgrading the plugin may overwrite existing configurations. Ensure you have backups or have noted down your settings before proceeding.
:::

## Uninstall the plugin

If you need to uninstall the Revolut Gateway for Adobe Commerce (Magento 2) plugin from your store, follow these steps.

- ![Uninstall via Composer (recommended)]

  ### Uninstall via Composer
  1. **Log in** to your Adobe Commerce server via SSH and navigate to your Adobe Commerce project's root directory.
  1. Disable the plugin:

      ```shell
      $ php bin/magento module:disable Revolut_Payment
      ```

  1. Remove the plugin using Composer:

      ```shell
      $ composer remove revolut/module-payment
      ```

  1. Open a terminal in the `magento2` root folder and run the commands in the provided code block to finish the uninstallation.

      ```shell
      $ php bin/magento setup:upgrade
      $ php bin/magento setup:di:compile
      $ php bin/magento setup:static-content:deploy
      ```

  1. When the uninstallation is done, flush the cache using the admin panel or the following terminal command.

      ```shell
      $ php bin/magento cache:flush
      ```

- ![Manual uninstallation]

  ### Manual uninstallation
  1. **Log in** to your Adobe Commerce server via SSH and navigate to your Adobe Commerce project's root directory.
  1. Disable the plugin:

      ```shell
      $ php bin/magento module:disable Revolut_Payment
      ```

  1. Remove the plugin files:

      ```shell
      $ rm -rf app/code/magento2
      ```

  1. Open a terminal in the `magento2` root folder and run the commands in the provided code block to finish the uninstallation.

      ```shell
      $ php bin/magento setup:upgrade
      $ php bin/magento setup:di:compile
      $ php bin/magento setup:static-content:deploy
      ```

  1. When the uninstallation is done, flush the cache using the admin panel or the following terminal command.

      ```shell
      $ php bin/magento cache:flush
      ```

---

## Troubleshooting

If you encounter issues during installation or upgrades:

- **PHP version:** Ensure that the PHP version used in the terminal matches the PHP version used by your Adobe Commerce store.
- **Memory limit:** Increase the PHP memory limit by setting the `memory_limit` variable in your `php.ini` file to at least `756M`.
- **Permissions:** Verify that your user account has the necessary permissions to run commands.
- Composer authentication: Ensure your Adobe Commerce authentication keys are correctly configured. Refer to the [Adobe Commerce authentication keys documentation](https://experienceleague.adobe.com/en/docs/commerce-operations/installation-guide/prerequisites/authentication-keys) for guidance.

:::warning
The **Revolut Gateway for Adobe Commerce (Magento 2)** plugin is compatible with Adobe Commerce versions from `2.4.x`.

For a plugin compatible with older versions you can [download the previous version](/assets/plugins/magento/revolut-gateway-v1.11.1-deprecated.zip). Bear in mind that this version is deprecated, and we do not offer support for it.
:::