# PrestaShop

{% hint style="info" %}
Available for PrestaShop 8.0 - 9.x
{% endhint %}

## General Information

PrestaShop is an open-source e-commerce platform that enables small and medium-sized businesses to create and manage their own online stores.

### Links

* PrestaShop [Website](https://prestashop.com/)
* PrestaShop [Documentation](https://doc.prestashop.com/)
* [Plugin](https://github.com/payrexx/prestashop-payrexx-gateway) Download

### Features

* ✅ Multi-currency support
* ✅ Payment method icons in checkout
* ✅ Cart transmission
* ✅ Webhook status synchronization
* ✅ Look & Feel configuration
* ✅ Individual payment method configuration
* ❌ Subscription support

{% hint style="info" %}
Please note that integration with PrestaShop is only available in the Standard and Premium plans. [For more information](https://payrexx.com/en/prices)
{% endhint %}

### Payment methods

The following payment methods are supported by the PrestaShop plugin:

<table data-full-width="true"><thead><tr><th width="206.74072265625">Payrexx Pay</th><th width="244.1112060546875">Payrexx Pay Plus</th><th width="197.5555419921875">External Payment Providers</th><th data-hidden></th></tr></thead><tbody><tr><td><img src="/files/WJVwKt7DxusvjH585W5R" alt="" data-size="line"> <a href="/pages/8yNTcYg81Qwv7VREKUIF">Mastercard</a></td><td><img src="/files/WJVwKt7DxusvjH585W5R" alt="" data-size="line"> <a href="/pages/8yNTcYg81Qwv7VREKUIF">Mastercard</a></td><td><img src="/files/78nPVauXSM5j8W1hf2DW" alt="" data-size="line"> Masterpass</td><td></td></tr><tr><td><img src="/files/8rrzZlphAr7Za4U5vnxE" alt="" data-size="line"> <a href="/pages/LdCqbL0vrX4CRIRpSXYN">Visa</a></td><td><img src="/files/8rrzZlphAr7Za4U5vnxE" alt="" data-size="line"> <a href="/pages/LdCqbL0vrX4CRIRpSXYN">Visa</a></td><td><img src="/files/Px5ih1Yy9TMEgVNjJr6C" alt="" data-size="line"> <a href="/pages/-M_fCRvhjSe_xp0bVopO">PayPal</a></td><td></td></tr><tr><td><img src="/files/O1IcwrLg6vHPIFMW71OG" alt="" data-size="line"> <a href="/pages/tn2AEjEp1riYNXRufL3w">PostFinance Pay</a></td><td><img src="/files/x9QwkL0vhKacPC1FbAdX" alt="" data-size="line"> <a href="/pages/CULvEQ5MyGPCgQil0NFP">American Express</a></td><td><img src="/files/qZPAwCRYFyVy7PuTqLyb" alt="" data-size="line"> Maestro</td><td></td></tr><tr><td><img src="/files/F5MKlDmJfiQrjosXATyg" alt="" data-size="line"> <a href="/pages/48Bh9N8bXYOSanBPFV7F">TWINT</a></td><td><img src="/files/KyMObC4NB9XLN5w6nG3b" alt="" data-size="line"> <a href="/pages/0j82hYUlcHfgEoAzqYtM">Diners Club International</a></td><td><img src="/files/187zwnGlPInPLD7hT3fM" alt="" data-size="line"> <a href="/pages/m766v217I1MxAXZ4F0va">HeyLight</a></td><td></td></tr><tr><td><img src="/files/yKiYgqRISlXfEtiodebx" alt="" data-size="line"> <a href="/pages/RippLLnzVKQ18a5NnxTV">Google Pay</a></td><td><img src="/files/hWsNhEecDhAgfFSuqIwO" alt="" data-size="line"> <a href="/pages/9ED8SqGhxqa26m8fKTxC">Discover Card</a></td><td><img src="/files/2ZameCpQlezKSA4Qsd5a" alt="" data-size="line"> Swissbilling</td><td></td></tr><tr><td><img src="/files/BVWsv9jejMUyMwxalT02" alt="" data-size="line"> <a href="/pages/-Ma2NHayOlG90QqRE5aF">Samsung Pay</a></td><td><img src="/files/ColBQLDwTZ1MfUOM545c" alt="" data-size="line"> <a href="/pages/qCkdWJg4Wrb6mGvgzgYL">Apple Pay</a></td><td><img src="/files/5akObsEJqWhUzdE9kuI8" alt="" data-size="line"> <a href="/pages/-M_uAXq3bMxkY9FacLyn">WIRpay</a></td><td></td></tr><tr><td><img src="/files/9nOxIIDiwvvsQ0Eo5PoP" alt="" data-size="line"> <a href="/pages/yv61YCASPtUr49LnyrdP">Pay by Bank</a></td><td><img src="/files/yKiYgqRISlXfEtiodebx" alt="" data-size="line"> <a href="/pages/RippLLnzVKQ18a5NnxTV">Google Pay</a></td><td> <img src="/files/86ZkIaXn72MK8od3KeRX" alt="" data-size="line"> <a href="/pages/-Ma2IVH0tr0RPF2SgSVP">Barzahlen/viacash</a></td><td></td></tr><tr><td><img src="/files/ZwwNMSVMl4Jh1fzAbmdA" alt="" data-size="line"> <a href="/pages/wwepYXQqxU940JaurJxX">Purchase on Invoice</a></td><td><img src="/files/5tUKnraMZivl4tDWvGfp" alt="" data-size="line"> <a href="/pages/93LqVe7o6JNKTfcqNvgm">Klarna</a></td><td><img src="/files/I2eINBnlQvxy9YMUhybE" alt="" data-size="line"><a href="/pages/-M_u_Bhz7NXU90kfAanO">giropay</a></td><td></td></tr><tr><td><img src="/files/wGozkDtDq52GpO78HKq1" alt="" data-size="line"> <a href="/pages/tXnCsIfUNpmTnnmpAmH0">Centi</a></td><td><img src="/files/VM14jT3ojujz8mjbwRMW" alt="" data-size="line"> <a href="/pages/Ft2eQ2bS5se2ZgHp3Zfd">eps</a></td><td><img src="/files/b98rHdQTVI0h3I1nAC79" alt="" data-size="line"> JCB</td><td></td></tr><tr><td><img src="/files/0qXmTTtejLWoCYW0xLH7" alt="" data-size="line"> <a href="/pages/RjyJlgsomeU324sQATMF">Crypto</a></td><td><img src="/files/ObTA7ODtdqlBNHECUkrL" alt="" data-size="line"> <a href="/pages/k7PfSWvskK5ek1fIw1P8">Bancontact</a></td><td><img src="/files/iSTlCDBYWrRW4MxIle3k" alt="" data-size="line"> <a href="/pages/-Ma2ITlSkH8zz-uuVtW-">Paysafecash</a></td><td></td></tr><tr><td></td><td> <img src="/files/d05P86Aln3PVhJVSqVsH" alt="" data-size="line"><a href="/pages/V2h1I5IYOFxzLDjRj95q">iDEAL</a></td><td><img src="/files/bXm8uob0fSJl5ilCPJKx" alt="" data-size="line"> Bitcoin</td><td></td></tr><tr><td></td><td><img src="/files/jhoMPS5HlmKY9gfqJaSu" alt="" data-size="line"> WeChat Pay</td><td><img src="/files/Y6Vg3EOODHSpYyKWW4Py" alt="" data-size="line"> <a href="/pages/Qs5X0wxESiTK2FORZnb5">Bill</a></td><td></td></tr><tr><td></td><td><img src="/files/DgvVLFu0B9jVbRnuQjFm" alt="" data-size="line"> <a href="/pages/dnNtwVeNi5gEu1SMR7Bq">Alipay</a></td><td><img src="/files/ur1Ki5bMiba6JtwhhPzx" alt="" data-size="line"> <a href="/pages/a9v9YNRbLeYm4y3XNpY9">POWERPAY</a></td><td></td></tr><tr><td></td><td><img src="/files/Nj3Zw8RydOrN1GtXcai1" alt="" data-size="line"> <a href="/pages/OyGj6W51V9vAYZ6jBBUE">SEPA Debit Direct</a></td><td><img src="/files/5HxCEkCzSYKmAjuumh81" alt="" data-size="line"> <a href="/pages/cmtHpDGTSBHLtCHkdhHa">CembraPay</a></td><td></td></tr><tr><td></td><td></td><td> <img src="/files/ti7V8srnwwwBhZKsS1qp" alt="" data-size="line"> <a href="/pages/wVvqPzh7NBzisgACLNBf">VERD</a></td><td></td></tr></tbody></table>

## Setup

Follow the instructions below to integrate Payrexx into PrestaShop.

### Configuration of Payrexx

{% hint style="info" %}
Make sure you're [logged in](https://login.payrexx.com/) to your Payrexx account before you begin. If you don’t have a Payrexx account yet, you can [register](https://signup.payrexx.com/) now.
{% endhint %}

* Navigate to the **API & Plugins** section in the merchant administration of your Payrexx account.
* Click on "Show All" below "Add E-Commerce Integration".
* Click on "Add" next to PrestaShop:

<figure><img src="/files/DPBwbmwaYsrkUuOanTWs" alt=""><figcaption><p>Configuration of PrestaShop in Payrexx</p></figcaption></figure>

* In the window below, apply the following settings:

<div align="left"><figure><img src="/files/T7vZ5NR1iJxinGaFtrFw" alt=""><figcaption><p>Configuring the connection between PrestaShop and Payrexx</p></figcaption></figure></div>

1. **API Key:** Copy the displayed API key to your clipboard, as you will need it later.
2. **Instance Name:** Copy the displayed instance name to your clipboard, as you will also need it later.
3. **Enter shop address:** In this field, enter the URL of your shop. If your shop is not located in the root directory (e.g., <https://my-shop.com>) but in a subdirectory, please enter the full path to your shop. Example: <https://my-shop.com/shop>

{% hint style="warning" %}
Please ensure that the shop URL is entered correctly. Any discrepancies (e.g. using http\:// instead of https\://) may cause errors when processing webhooks.
{% endhint %}

4. **Webhooks:** Define whether a failed webhook should be retried. If the checkbox is activated, the system will attempt to resend the webhook up to 10 times. The retry intervals are as follows: 5 minutes, 15 minutes, 1 hour, 2 hours, 4 hours, and then every 24 hours.
5. **Finalize:** Click the green "Activate" button to complete the configuration.

### Plugin installation

* Download the latest version of the [plugin](https://github.com/payrexx/prestashop-payrexx-gateway) from GitHub:&#x20;

<div align="left"><figure><img src="/files/4O7FxqBxNVfpztIWhWfe" alt=""><figcaption><p>Download the ZIP file from GitHub</p></figcaption></figure></div>

* Extract the file *prestashop-payrexx-gateway-master.zip*.
* Open the folder containing the *payrexx* subfolder and the *.gitignore* file.
* Compress the *payrexx* folder into a ZIP file.
* Log in to your PrestaShop account.
* Navigate to **Modules > Module Manager**.
* Click on the <img src="/files/3KJBuVMnNsihxI7FqKDY" alt="" data-size="line"> button.
* Upload the ZIP file of the plugin.

### Configuration of PrestaShop

* Navigate to **Modules > Module Manager**.
* Set the Category field filter to "Payment":

<div align="left"><figure><img src="/files/l3ZZJV0KrNPrhdPoijVl" alt=""><figcaption><p>Showing the payment modules</p></figcaption></figure></div>

* Scroll down to Payrexx and click "Settings":

<div align="left"><figure><img src="/files/uKdj72VOsaPcNTEtCUSZ" alt=""><figcaption><p>Accessing the Payrexx module settings</p></figcaption></figure></div>

PrestaShop can be connected to Payrexx in two ways – automatically or manually:

**Automatically connect PrestaShop to Payrexx**

* Click the "Connect With Platform" button to establish the connection to Payrexx:

<div align="left"><figure><img src="/files/OSfnFRctJjcSTwsfW3nv" alt=""><figcaption><p>Automatic connection of PrestaShop and Payrexx</p></figcaption></figure></div>

**Manually connect PrestaShop to Payrexx**

* Fill in the following fields to manually establish the connection to Payrexx:

<div align="left"><figure><img src="/files/KMNVwRd4b42sU14azjHo" alt=""><figcaption><p>Manual connection of PrestaShop and Payrexx</p></figcaption></figure></div>

1. **Payrexx Platform:** Select the platform where your Payrexx account is located.
2. **API Secret:** Enter the API key that was generated during the [configuration of Payrexx](#configuration-of-payrexx).
3. **Instance Name:** Enter the instance name of your Payrexx account. The instance name corresponds to the first part of your Payrexx URL. For example, if your URL is *example*.payrexx.com, the instance name is *example*.
4. **Look and Feel Profile ID:** Optionally, enter the ID of the desired [Look & Feel profile](/merchant/english/account/settings/look-and-feel.md).

{% hint style="success" %}
The connection between Payrexx and PrestaShop has been successfully established.
{% endhint %}

* Navigate to **Advanced Parameters > Performance**.
* In the "Smarty" section, ensure that the option "Recompile templates if the files have been updated" is selected next to "Template compilation":

<div align="left"><figure><img src="/files/JfB2ocMmRfXULVzVPDq7" alt=""><figcaption><p>Template compilation settings in PrestaShop</p></figcaption></figure></div>

### Configuration of Payment Methods

In this section, you will learn how to configure the payment methods available for your customers in your PrestaShop store.

* Navigate to **Modules > Module Manager**.
* Scroll down to the "Payment Methods" section.
* Select the payment methods you want to enable:

<div align="left"><figure><img src="/files/ouWP3m9hsTykTVuroyf0" alt=""><figcaption><p>Management of payment methods in PrestaShop</p></figcaption></figure></div>

## Order from the Customer’s Perspective

The following steps illustrate how a customer places and pays for a product on a website using PrestaShop with the integrated Payrexx payment solution:

The customer selects a product and adds it to the cart:

<div align="left"><figure><img src="/files/UaWhXq6zZqswrt4bSqPq" alt=""><figcaption><p>Selecting the product "Hummingbird printed sweater"</p></figcaption></figure></div>

The customer clicks the “Proceed to checkout” button:

<div align="left"><figure><img src="/files/S6axjj4qtJF9CBms5e7s" alt=""><figcaption><p>Proceed to checkout</p></figcaption></figure></div>

The customer fills in the required fields and accepts the terms and conditions and privacy policy:

<div align="left"><figure><img src="/files/KrwoduVyZtNBwCaQlhwh" alt=""><figcaption><p>Filling in the form fields and accepting the terms and conditions</p></figcaption></figure></div>

The customer selects "Payrexx" under "Payment", and the payment methods enabled in Payrexx appear – in this example: [Mastercard](/merchant/english/payment-provider/payrexx-pay/payment-methods/mastercard.md), [Visa](/merchant/english/payment-provider/payrexx-pay/payment-methods/visa.md), [Purchase on Invoice](/merchant/english/payment-provider/payrexx-pay/payment-methods/purchase-on-invoice.md), and [TWINT](/merchant/english/payment-provider/payrexx-pay/payment-methods/twint.md):

<div align="left"><figure><img src="/files/KCipqsxEWdfLzyO6BCmB" alt=""><figcaption><p>Selecting Payrexx</p></figcaption></figure></div>

The customer completes the order on the website by:

1. choosing one of the available payment methods (e.g., Visa)
2. accepting the terms of service
3. clicking "Place order"

<div align="left"><figure><img src="/files/VrI5UZ2K2jRW5WtifB73" alt=""><figcaption><p>Selecting the payment method Visa</p></figcaption></figure></div>

The customer is then redirected to Payrexx to complete the order:

<div align="left"><figure><img src="/files/SzrmrAY4WiuPZZhJDITt" alt="" width="282"><figcaption><p>Completing the order on Payrexx</p></figcaption></figure></div>

After completing the order, the customer is redirected back to the website, where the order and payment confirmation is displayed:

<div align="left"><figure><img src="/files/7MZx81t95kQFQjXs9BC8" alt=""><figcaption><p>Order confirmation displayed in the webshop</p></figcaption></figure></div>

{% hint style="success" %}
The order is now successfully completed.
{% endhint %}

### Place your own test order

If you want to see how an order works from the customer’s perspective, visit our [demo shop](https://showcase.payrexx.com/prestashop/) and place a test order.

For more information and test credit card details, please refer to the following article:

{% content-ref url="/pages/-MdNTXs1Cj\_H0MnJqHLN" %}
[Testing](/merchant/english/payment/testing.md)
{% endcontent-ref %}


---

# 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.payrexx.com/merchant/english/integration/e-commerce/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.
