# Upgrade your Magento 2 integration to Flow

Follow this guide to upgrade your Magento 2 plugin to Flow.

---

## Before you start

- Ensure that your WordPress and Magento 2 instances are up to date.
- You need the following Checkout.com API credentials:
  - Public key
  - Secret key
  - Signature key

To upgrade your Magento 2 integration, follow these steps:

1. Install the updated plugin.
2. Configure the plugin.
3. Test your updated integration.

---

## Install the updated plugin

You can install the plugin in the following ways:

- Using Composer
- Using Magento Marketplace

### Using Composer

1. Go to the root directory of your Magento 2 server.
2. Use the following commands to install the plugin:
   - `composer require checkoutcom/magento2:7.0`
3. You receive a success message confirming the installation of Checkout.com's PHP SDK and plugin.
4. Recompile your Magento 2 installation and clear the cache before configuring it. Enter the following commands in order:

   1. `php bin/magento setup:upgrade`
   2. `rm -rf var/cache var/generation/ var/di`
   3. `php bin/magento setup:di:compile`
   4. `php bin magento cache:clean`

### Using Magento Marketplace

1. Install the plugin from [Magento Marketplace](https://marketplace.magento.com/checkoutcom-magento2.html).
2. Follow the installation instructions on the checkout page.
3. Sign in to your Magento Admin Panel.
4. Go to _Stores_ > _Configuration_ > _Sales_ > _Payment Methods_. <br>
If successful, Checkout.com appears in the list of payment methods.

---

## Configure the plugin

1. Sign in to your Magento Admin Panel.
2. Go to _Stores_ > _Configuration_ > _Sales_ > _Payment Methods_.
3. Find the Checkout.com plugin and select _Configure_.

### Global settings

1. In the configuration panel, go to _Configuration_ > _Global Settings_.
2. Make sure _Environment_ is set to _Test_ so you can start testing card payments.
3. Select the _Payment Action_:

    - The _Authorize and Capture_ option means that the charge is authorized and captured (that is, the money due from the customer's account is moved into your account) at the same time.
    - The _Authorize_ option only authorizes the charge. You have to capture the payment manually.

If you're unsure, we recommend _Authorize and Capture_.

### Account settings

1. In the configuration panel, go to _Configuration_ > _Account Settings_.
2. Enter your _Secret Key_ and _Public Key_. When testing, make sure you use the sandbox API keys.
3. In the _Authorization Header Key_ field, copy and paste the authorization header key from the _Developers_ > _Keys_ section of your Checkout.com Dashboard.
4. Select _Set Webhooks_ to automatically register your webhooks in the Checkout.com Dashboard.
5. Select _Save Config_.

---

## Test your updated integration

Follow the [Magento 2 test instructions](https://www.checkout.com/docs/payments/accept-payments/connect-to-our-integration-partners/magento-2.md#Test_your_integration) and validate that the order updates correctly on your Magento 2 dashboard.

---

## Go live

After ensuring that your integration works, you can move your integration to production:

1. Switch the _Environment_ to _Production_ in the plugin's settings.
2. Replace the sandbox API keys in the plugin's settings with the production API keys.
3. Configure the webhook URLs in your live Dashboard account.