# Integrate WooCommerce

## Overview

WooCommerce is a plugin that integrates easily with any website built on WordPress. The plugin helps merchants turn their websites into fully functional WordPress eCommerce platforms with just a few clicks.

WooCommerce offers online retailers a suite of services including payments, marketing, shipping, and customer engagement tools to simplify the process of running an eStore for small and enterprise merchants.

{% hint style="info" icon="lightbulb" %}

#### Related links

Want to process payments through the 2Checkout platform and integrate with us within minutes? Choose from a list of +100 connectors and leverage our capabilities to simplify the way you handle payments.

<a href="https://www.2checkout.com/digital-commerce/" class="button primary" data-icon="book-open-lines">Read more</a>
{% endhint %}

## Availability

WooCommerce integration is available only for 2Checkout accounts that handle their own tax and invoice management (2Sell and 2Subscribe accounts).

## WooCommerce Settings

Regardless of whether you are already using the WooCommerce connector or you want to start integrating with 2Checkout to receive payments, you need to follow the steps below:

{% hint style="warning" %}
Current module version is **not compatible with WooCommerce 8.0** (High-Performance Order Storage). A new compatible version will soon be released.
{% endhint %}

1. Download the 2Checkout payment module from [GitHub](https://github.com/2Checkout/woocommerce/tree/release) by clicking on the **Code** button and then on **Download ZIP**.<br>

   <div data-with-frame="true"><figure><img src="/files/wQvKd7nsp8er4rQhxb63" alt=""><figcaption></figcaption></figure></div>
2. After downloading the .zip archive, open it and extract the folders **twocheckout-convert-plus**, **twocheckout-inline**, and **twocheckout**. Archive these folders separately as a .zip file.
3. Log in to your WordPress admin, navigate to *Plugins,* and click on **Add new**.<br>

   <div data-with-frame="true"><figure><img src="/files/fRUntS2fLaeu0CYxChPH" alt=""><figcaption></figcaption></figure></div>
4. On the *Add plugins* page, click on **Upload plugin**, then on **Choose File** and on **Install Now**.<br>

   <div data-with-frame="true"><figure><img src="/files/vrFP7kUWusJqz4sdCGgA" alt=""><figcaption></figcaption></figure></div>
5. On the *Plugins* page, **activate the modules** for ConvertPlus, InLine cart, and 2Pay.js by checking the boxes and clicking on the **Apply** button.<br>

   <div data-with-frame="true"><figure><img src="/files/4LS8MsBpML2qqnJLb3VC" alt=""><figcaption></figcaption></figure></div>
6. Go back to *Dashboard*, scroll down to *WooCommerce*, and click on **Settings**.<br>

   <div data-with-frame="true"><figure><img src="/files/2MkeW14N7bK1ACzublAG" alt=""><figcaption></figcaption></figure></div>
7. Under *WooCommerce - Settings*, click on the **Payments** tab.<br>

   <div data-with-frame="true"><figure><img src="/files/oewq7SOuNOtGoQFBEm1l" alt=""><figcaption></figcaption></figure></div>
8. **Enable all three modules** and then click on **Set up** to configure each module.<br>

   <div data-with-frame="true"><figure><img src="/files/v64YAG2ZGNcc35cYs58p" alt=""><figcaption></figcaption></figure></div>
9. Configure each module by filling in all the fields:
   * Input a **Title** and **Description** for the module. These fields control how your users will see the module during checkout.
   * Input the **Seller ID**. Your Seller ID is the **Merchant Code** from the 2Checkout Merchant Control Panel. To copy this code from 2Checkout and paste it in the WooCommerce platform:
     * Log in to your 2Checkout [Merchant Control Panel](https://secure.2checkout.com/cpanel) and navigate to *Integrations → Webhooks & APIs*. Copy the Merchant Code from the **API** section and paste it into the Seller ID field in WooCommerce.
   * Input the **Secret Key**. To copy the Secret Key from 2Checkout and paste it in the WooCommerce platform:
     * Log in to your 2Checkout [Merchant Control Panel](https://secure.2checkout.com/cpanel) and navigate to *Integrations → Webhooks & APIs*. Copy the Secret Key from the **API** section and paste it into the Secret Key field in WooCommerce.
   * Input the **Secret Word**. Your Secret Word is the **Buy-Link Secret Word** from the 2Checkout Merchant Control Panel. To copy this code from 2Checkout and paste it in the WooCommerce platform:
     * Log in to your 2Checkout [Merchant Control Panel](https://secure.2checkout.com/cpanel) and navigate to *Integrations → Webhooks & APIs*. Go to the **Secret Word** section, edit the **INS Secret Word** to match the **Buy-Link Secret Word**, then copy the code and paste it into the Secret Word field in WooCommerce.
   * Fill in the **IPN URL**.
   * Check the **Debug Log** option if you want to log 2Checkout events.
   * Check the **Demo order** option if you want to be able to place test orders.<br>

     <div data-with-frame="true"><figure><img src="/files/SgKl2DazzKg1il0AsLYh" alt=""><figcaption></figcaption></figure></div>
10. Click on **Save changes**.<br>

    <div data-with-frame="true"><figure><img src="/files/NKoUhf26r3gFbr8v3YZR" alt=""><figcaption></figcaption></figure></div>
11. Test your integration by placing an order. If your setup is correct,
    * the ConvertPlus flow will look as below<br>

      <div data-with-frame="true"><figure><img src="/files/eCnkcjxMdVH938yiVeWZ" alt=""><figcaption></figcaption></figure></div>
    * the InLine checkout flow will look like this<br>

      <div data-with-frame="true"><figure><img src="/files/3t7dEOLDvXGDUtwx5JIv" alt=""><figcaption></figcaption></figure></div>
    * the 2Pay.js flow will be displayed as shown below. You can customize the form by using the **Custom style** option.<br>

      <div data-with-frame="true"><figure><img src="/files/PynfA6E1poabaUValNbm" alt=""><figcaption></figcaption></figure></div>

      <div data-with-frame="true"><figure><img src="/files/oyyLzjZ1EvrDLF555wfx" alt=""><figcaption></figcaption></figure></div>

## 2Checkout Settings

1. Sign in to your 2Checkout account.
2. Navigate to *Dashboard → Integrations → Webhooks & API section*.<br>

   <div data-with-frame="true"><figure><img src="/files/y7fVnMjGyxQpLiTzSr9O" alt=""><figcaption></figcaption></figure></div>
3. Follow these steps to activate Redirect URL:
   * In the *Redirect URL* section, check **Enable return after sale**
   * For *Redirect URL* section, set the **Approved URL** to your WooCommerce URL
   * For the *Return* method, select **Header Redirect**
4. Click **Update** to save your settings.
5. Make sure to enable the [IPN webhook notification in your Merchant Control Panel](https://secure.2checkout.com/cpanel/webhooks_api.php).
   * Log in to the 2Checkout Merchant Control Panel and navigate to *Integrations → Webhooks & API*
   * Scroll down to the *Notifications* section and enable the **IPN** webhook<br>

     <div data-with-frame="true"><figure><img src="/files/6XEX4FVQ1riHc4OBxFaz" alt=""><figcaption></figcaption></figure></div>
   * For the **Payment notification type** field, select **IPN** or **Email Text & IPN**, and then click on the **Configure IPN** button.
   * On the [IPN settings page](https://secure.2checkout.com/cpanel/ipn_settings.php), click on the **Add IPN URL** button, input the IPN URL available on the configuration page in WooCommerce, and select the SHA-2/SHA-3 hash.<br>

     <div data-with-frame="true"><figure><img src="/files/4FsdFfVfnhlfpGCkOBQZ" alt=""><figcaption></figcaption></figure></div>
   * Enable all triggers and response tags<br>

     <div data-with-frame="true"><figure><img src="/files/svtUKtn8lcEiizBOjE9f" alt=""><figcaption></figcaption></figure></div>

## About WooCommerce

WooCommerce is the most popular WordPress eCommerce plugin. And it’s available for free. Packed full of features, perfectly integrated into your self-hosted WordPress website. For more information, visit: [woothemes.com/woocommerce](http://www.woothemes.com/woocommerce/).

## FAQ

<details>

<summary>Does the new connector use webhooks?</summary>

Yes, it uses IPN, so make sure you enable it from your Merchant Control Panel.

</details>

<details>

<summary>Do order statuses get updated on the WooCommerce side if any change occurs after place order?</summary>

Yes, both order and fraud statuses are synchronized, as well as refunds.

</details>

<details>

<summary>Can I place refunds?</summary>

Yes. You can place refunds from the WooCommerce portal.

</details>

<details>

<summary>Can I use this connector with a 2Monetize account?</summary>

No, the connector is built to cover only the 2Sell and 2Subscribe accounts.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.2checkout.com/connectors/connectors/integrate-woocommerce.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.