# Upgrade your WooCommerce integration to Flow

Follow this guide to upgrade your WooCommerce plugin to Flow.

---

## Before you start

- Ensure that your WordPress and WooCommerce instances are up to date.
- Ensure that your required alternative payment methods (APMs) are:
    - Supported by Flow
    - Selected under _Enabled Payment Methods_ in the Dashboard
- You need the following Checkout.com API credentials:
  - Public key
  - Secret key
  - Signature key

To upgrade your WooCommerce integration, follow these steps:

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

---

## Install the updated plugin

You can install the plugin in the following ways:

- Use the WordPress plugin directory.
- Download the plugin and install it manually.

### Use the WordPress plugin directory

1. Sign in to WordPress as an administrator.
2. In your WordPress dashboard, go to _Plugins_ > _Add New_.
3. Search for _Checkout.com Payment Gateway_.
4. Select _Install Now_.
5. After the installation completes, select _Activate Plugin_.

### Download the plugin

1. Go to the [WooCommerce plugin repository](https://github.com/checkout/checkout-woocommerce-plugin/tags).
2. Download the latest release of the plugin.
3. Sign in to WordPress as an administrator.
4. In your WordPress dashboard, go to _Plugins_ > _Add New_.
5. Select _Upload Plugin_ > _Choose file_.
6. Upload the ZIP file you downloaded.
7. Select _Install Now_.
8. After the installation completes, select _Activate Plugin_.

---

## Upgrade the plugin

1. In your WordPress dashboard, go to _Plugins_ > _Checkout.com Payment Gateway_ > _Quick Settings_.
2. Under _Checkout mode_, select _Flow_.
If you need more time to migrate, you can set _Checkout mode_ to _Classic_ in your production environment.
3. Set _Environment_ to _SandBox_.
4. Your existing public and secret keys are pre-populated during the upgrade.
To ensure that you keep using the processing channel you configured, enter your existing Checkout.com sandbox public and secret keys.
5. Set the _Payment Method Title_ to the name you want customers to see at checkout. For example, _Credit/Debit Card_.
6. Under _Webhook Status_, select _Refresh Status_ to verify the webhook configuration.
  - If the verification fails, select _Register Webhook_ in _Register New Webhook_.

If you require fast checkout, follow the instructions under _Express Payments_.

To customize your Flow interface changes, update the _Flow Settings_.

---

## Upgrade alternative payment methods

### Apple Pay

If you configured Apple Pay for the regular checkout page:

1. Follow the [Apple Pay for web](https://www.checkout.com/docs/payments/add-payment-methods/apple-pay/web.md) instructions.
2. In the _Quick setup_ box, enable Apple Pay.

If you configured Apple Pay for express checkout:

1. Go to the _Express Checkout_ settings.
2. Verify that the existing Apple Pay settings are correct.
3. Enable _Fast Checkout_.

### Google Pay

If you configured Google Pay for the regular checkout page, enable Google Pay in the _Quick setup_ box.

If you configured Google Pay for express checkout:

1. Go to the _Express Checkout_ settings.
2. Verify that the existing Google Pay settings are correct.
3. Enable _Fast Checkout_.

### PayPal

If you configured PayPal for the regular checkout page, enable PayPal in the _Quick setup_ box.

If you configured PayPal for express checkout:

1. Go to the _Express Checkout_ settings.
2. Verify that the existing PayPal settings are correct.
3. Enable _Fast Checkout_.

---

## Test your updated integration

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

---

## Go live

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

1. In your WordPress dashboard, go to _Plugins_ > _Checkout.com Payment Gateway_ > _Settings_.
2. Set _Environment_ to _Live_.
3. Set _Secret Key_ and _Public Key_ to your secret and public keys for your Checkout.com production environment.