# Integrate PrestaShop

## Overview

Merchants can use the PrestaShop connector to integrate with 2Checkout and process orders with ConvertPlus, InLine Cart, and 2Pay.js, and provide an improved experience to their shoppers.

## Availability

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

## PrestaShop Settings

Regardless you are already using the PrestaShop connector or you want to start integrating with 2Checkout, you need to follow the steps below:

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

   <div data-with-frame="true"><figure><img src="/files/mYZwUwy7t81KI4nQN4gi" alt=""><figcaption></figcaption></figure></div>
2. After downloading the .zip archive, open it and extract the folder **twocheckout**, then archive it separately as a .zip file.
3. Sign in to your PrestaShop admin and navigate to *Modules → Module Manager*.<br>

   <div data-with-frame="true"><figure><img src="/files/1IPJPKD9pANy3mEUrJ1m" alt=""><figcaption></figcaption></figure></div>
4. On the **Module Manager** page, click on **Upload module** and upload the **twocheckout** .zip folder.<br>

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

   <div data-with-frame="true"><figure><img src="/files/PgqPD8VUrfB8PIVVwt9S" alt=""><figcaption></figcaption></figure></div>
5. After upload, the new module will appear as shown here:<br>

   <div data-with-frame="true"><figure><img src="/files/uk4yvRP98GBdTMjsDxSg" alt=""><figcaption></figcaption></figure></div>
6. Click on **Configure** to add your information:
   * Seller ID (Merchant Code)
   * Buy Link Secret Word
   * Secret Key
   * Select the cart type:
     * API (to use [2Pay.js](https://verifone.cloud/docs/2checkout/API-Integration/2Pay.js-payments-solution/))
     * [ConvertPlus](https://verifone.cloud/docs/2checkout/Documentation/07Commerce/2Checkout-ConvertPlus/)
     * [InLine](https://verifone.cloud/docs/2checkout/Documentation/07Commerce/InLine-Checkout-Guide/)
   * Select "Demo mode" if you wish to enable it. This will allow you to place test orders using [test payment methods](https://verifone.cloud/docs/2checkout/Documentation/09Test_ordering_system/01Test_payment_methods/), to check your integration with 2Checkout.
   * Select the style for the API form. You can choose to use the "Default style" or you can customize it by implementing the code snippet provided there.<br>

     <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><ul><li>The Seller ID is your 2Checkout Merchant Code that you can obtain by logging in to your Merchant Control Panel and navigating to <em>Integrations → Webhooks &#x26; API.</em> </li><li><em>To find the Buy Link Secret Word, lo</em>g  in to your 2 Checkout Merchant Control Panel and navigate to <em>Integrations → Webhooks &#x26; API → Secret Word . Edit your  INS Secret Word to match the Buy Link Secret Word , copy the value and paste it in the PrestaShop admin.</em></li><li><em>The Secret key can be found in your 2Checkout Merchant Control Panel, right next to the Merchant Code. Copy and paste it in your PrestaShop admin.</em></li></ul></div>

     <div data-with-frame="true"><figure><img src="/files/arCFm0sSne4A0vHAqwMn" alt=""><figcaption></figcaption></figure></div>
7. Once you've filled in all the information, click on **Update settings** at the bottom of the page.<br>

   <div data-with-frame="true"><figure><img src="/files/OF0AuqryJxW9Vvy59gp2" alt=""><figcaption></figcaption></figure></div>
8. Test your integration by placing an order. If your set-up is correct, you will be able to see the **Pay with 2Checkout** option:
   * for ConvertPlus and InLine checkout flow<br>

     <div data-with-frame="true"><figure><img src="/files/f0vIhwtFgYD4mxSltNb4" alt="" width="493"><figcaption></figcaption></figure></div>
   * for 2Pay.js checkout flow<br>

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

## 2Checkout Settings

1. Sign in to your 2Checkout account.
2. Navigate to *Dashboard → Integrations → Webhooks & API*
3. Follow these steps to activate Redirect URL:
   * In the **Redirect URL** section check **“Enable return after sale”**
   * For Return method, select **Header Redirect**
   * Set the **Approved URL** to [https://www.yourstore.com/index.php?...ler=validation](https://www.yourstore.com/index.php?fc=module\&module=twocheckoutpp\&controller=validation)’ (Replace ‘[https://www.yourstore.com](https://www.yourstore.com/)’ with the actual URL to your store).
4. Click **Update** to save your changes.
5. Make sure to enable the [IPN webhook notification in your Merchant Control Panel](https://secure.2checkout.com/cpanel/webhooks_api.php).&#x20;
   * 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/exqJNtwD9YbmjpbnV3T8" 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 and input the IPN URL available in the configuration page in Prestashop.<br>

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

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

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

## About PrestaShop

PrestaShop is an eCommerce marketplace for small and medium merchants and offers them a variety of tools to download that help them build their online businesses. Fast, efficient, and easy to use, PrestaShop’s free eCommerce solution provides everything merchants need to open, operate, and maintain a successful online store.

For more information visit [PrestaShop.com](http://www.prestashop.com/).

## FAQs

<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 PrestaShop 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, but only from the 2Checkout Control Panel. You will be able to place refunds from the PrestaShop portal in the next release of the connector.

</details>

<details>

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

No, you can't. This 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-prestashop.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.
