# PrestaShop

{% hint style="info" %}
Verfügbar für Prestashop 8.0 - 9.x
{% endhint %}

## Allgemein

PrestaShop ist eine Open-Source-E-Commerce-Plattform, mit der kleine und mittelgrosse Unternehmen ihre eigenen Online-Shops erstellen und verwalten können.

### Links

* [Webseite](https://www.prestashop.com/) von PrestaShop
* [Dokumentation](https://doc.prestashop.com/) von PrestaShop
* Download des [Plugins](https://github.com/payrexx/prestashop-payrexx-gateway)

### Funktionen

* ✅ Mehrwährungs-Fähigkeit
* ✅ Zahlungsmittel-Logos im Checkout
* ✅ Übertragung Warenkorb
* ✅ Webhook-Fähigkeit
* ✅ Einstellungen zu Look & Feel
* ✅ Individuelle Zahlungsmittel-Konfiguration
* ❌ Abonnement-Support

{% hint style="info" %}
Bitte beachte, dass die Integration in PrestaShop nur in den Preisplänen "Standard" und "Premium" verfügbar ist. [Weitere Informationen](https://payrexx.com/de-ch/preise)
{% endhint %}

### Zahlungsarten

Die folgenden Zahlungsarten werden vom PrestaShop-Plugin unterstützt:

<table><thead><tr><th width="206.74072265625">Payrexx Pay</th><th width="244.1112060546875">Payrexx Pay Plus</th><th width="197.5555419921875">Externe Zahlungsanbieter</th><th data-hidden></th></tr></thead><tbody><tr><td><img src="/files/WJVwKt7DxusvjH585W5R" alt="" data-size="line"> <a href="/pages/CKn3b4eaRJy2uO24TSpA">Mastercard</a></td><td><img src="/files/WJVwKt7DxusvjH585W5R" alt="" data-size="line"> <a href="/pages/CKn3b4eaRJy2uO24TSpA">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/jOfvr6ZV7dkHYrHdo7M7">Visa</a></td><td><img src="/files/8rrzZlphAr7Za4U5vnxE" alt="" data-size="line"> <a href="/pages/jOfvr6ZV7dkHYrHdo7M7">Visa</a></td><td><img src="/files/Px5ih1Yy9TMEgVNjJr6C" alt="" data-size="line"> <a href="/pages/-Mad3-fv8GUkyRLLTdXr">PayPal</a></td><td></td></tr><tr><td><img src="/files/O1IcwrLg6vHPIFMW71OG" alt="" data-size="line"> <a href="/pages/5QggD8K6uU69IO1qbnZQ">PostFinance Pay</a></td><td><img src="/files/x9QwkL0vhKacPC1FbAdX" alt="" data-size="line"> <a href="/pages/FQSJm3zCZK2v5Qr6uiRx">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/CANB6YviRKn9Ghsr7rpp">TWINT</a></td><td><img src="/files/KyMObC4NB9XLN5w6nG3b" alt="" data-size="line"> <a href="/pages/Z7BFQVofdwhfnKPD7GKz">Diners Club International</a></td><td><img src="/files/187zwnGlPInPLD7hT3fM" alt="" data-size="line"> <a href="/pages/e8ZU2TkSLtgrun1Gc9cf">HeyLight</a></td><td></td></tr><tr><td><img src="/files/mHBaNNg7uf5Rkc7OSCOF" alt="" data-size="line"> <a href="/pages/eAZKWxFOksWPupUZWcXm">Google Pay</a></td><td><img src="/files/hWsNhEecDhAgfFSuqIwO" alt="" data-size="line"> <a href="/pages/2oWxoDMQbzHIVCws4ROd">Discover Card</a></td><td><img src="/files/2ZameCpQlezKSA4Qsd5a" alt="" data-size="line"> Swissbilling</td><td></td></tr><tr><td><img src="/files/wPYyJDLY9oVbPd1HUC5J" alt="" data-size="line"> <a href="/pages/-MamW0PtRDsBUXGvbS-_">Samsung Pay</a></td><td><img src="/files/4WbXC1jE7rF4vFzTWeRn" alt="" data-size="line"> <a href="/pages/uAo8PmPGb2NO0i5PAhYv">Apple Pay</a></td><td><img src="/files/5akObsEJqWhUzdE9kuI8" alt="" data-size="line"> <a href="/pages/-Mad30Eoy2Pbb2UmEcca">WIRpay</a></td><td></td></tr><tr><td><img src="/files/9nOxIIDiwvvsQ0Eo5PoP" alt="" data-size="line"> <a href="/pages/3FU6mgXZmso1rz0AQAV4">Pay by Bank</a></td><td><img src="/files/mHBaNNg7uf5Rkc7OSCOF" alt="" data-size="line"> <a href="/pages/eAZKWxFOksWPupUZWcXm">Google Pay</a></td><td> <img src="/files/86ZkIaXn72MK8od3KeRX" alt="" data-size="line"> <a href="/pages/-Mad432nUsmfccsz4Wyw">Barzahlen/viacash</a></td><td></td></tr><tr><td><img src="/files/ZwwNMSVMl4Jh1fzAbmdA" alt="" data-size="line"> <a href="/pages/iM2anRm1uQ5M0Hj8HoVG">Kauf auf Rechnung</a></td><td><img src="/files/5tUKnraMZivl4tDWvGfp" alt="" data-size="line"> <a href="/pages/Lj07FlegH735swR9HeIr">Klarna</a></td><td><img src="/files/I2eINBnlQvxy9YMUhybE" alt="" data-size="line"><a href="/pages/-Mad45CsDGyAtvGZ2mKl">giropay</a></td><td></td></tr><tr><td><img src="/files/oaaSznByCekbaAIykjdx" alt="" data-size="line"> <a href="/pages/fliVkvByHyJFkW8Ji6fT">Centi</a></td><td><img src="/files/hFFsYqLAc6lOlTTWaTvr" alt="" data-size="line"> <a href="/pages/Ta4X74rK1UFRtGWxBz7N">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/wrjxDTCFEgOXup9AlK1r">Crypto</a></td><td><img src="/files/WlZTxTH2yBfKtfUpNp3r" alt="" data-size="line"> <a href="/pages/UEtOuMqCI7bsdUwghmPx">Bancontact</a></td><td><img src="/files/w2hYB6OtrE63bPCPJ6JY" alt="" data-size="line"> <a href="/pages/-Mad44Oc8QRG9BQRJ2pQ">Paysafecash</a></td><td></td></tr><tr><td></td><td><img src="/files/JDgqhjvu4unIcyE6fY7U" alt="" data-size="line"> <a href="/pages/UD1145eSo3qeqePc1fdY">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/FHGc9AT6aeuXZHXxbFMo">Rechnung</a></td><td></td></tr><tr><td></td><td><img src="/files/DgvVLFu0B9jVbRnuQjFm" alt="" data-size="line"> <a href="/pages/Hyj0Vkkt8D8NwUj0ccOm">Alipay</a></td><td><img src="/files/ur1Ki5bMiba6JtwhhPzx" alt="" data-size="line"> <a href="/pages/bL8gxc3pRsEUhGQuCc6R">POWERPAY</a></td><td></td></tr><tr><td></td><td><img src="/files/m6WuTovbzXMwjMwTIwpN" alt="" data-size="line"> <a href="/pages/7NM6bXgdvaCYIwi9wnD6">SEPA Direct Debit</a></td><td><img src="/files/5HxCEkCzSYKmAjuumh81" alt="" data-size="line"> <a href="/pages/RYopGQn4Hpo3myV5kd8u">CembraPay</a></td><td></td></tr><tr><td></td><td></td><td> <img src="/files/ti7V8srnwwwBhZKsS1qp" alt="" data-size="line"> <a href="/pages/-Mad44Oc8QRG9BQRJ2pQ">VERD</a></td><td></td></tr></tbody></table>

## Setup

Folge der untenstehenden Anleitung, um Payrexx in PrestaShop zu integrieren.

### Konfiguration von Payrexx

{% hint style="info" %}
Bitte beachte, dass Du bei Payrexx [eingeloggt](https://login.payrexx.com/de) sein musst, bevor Du beginnst. Falls Du noch kein Konto hast, [registriere](https://signup.payrexx.com/de/email-validation/) Dich bitte bei Payrexx.
{% endhint %}

* Navigiere in der Händler-Administration Deines Payrexx-Kontos zu **API und Integrationen**.
* Klicke unterhalb von "E-Commerce-Integration hinzufügen" auf "Alle anzeigen".
* Klicke neben PrestaShop auf "Hinzufügen":

<div align="left"><figure><img src="/files/UygDa2U5jS4JBRv2Xjaa" alt=""><figcaption><p>Konfiguration des Plugins für PrestaShop</p></figcaption></figure></div>

* Nimm im untenstehenden Fenster die folgenden Einstellungen vor:

<div align="left"><figure><img src="/files/y8tvXAZMNeH1Wmo0QUub" alt=""><figcaption><p>Konfiguration der Anbindung von PrestaShop in Payrexx</p></figcaption></figure></div>

1. **API-Schlüssel:** Kopiere den angezeigten API-Schlüssel in die Zwischenablage, da Du ihn später benötigst.
2. **Instanzname:** Kopiere den angezeigten Instanznamen in die Zwischenablage, da Du ihn später benötigst.
3. **Shop-Adresse eingeben:** Erfasse in diesem Feld die URL Deines Shops. Falls sich Dein Shop nicht im Hauptverzeichnis (<https://demo-shop.com>) befindet, sondern in einem Unterverzeichnis, gibt bitte den kompletten Pfad zu Deinem Shop an. Beispiel: <https://demo-shop.com/shop>

{% hint style="warning" %}
Bitte beachte, dass Du die Shop-Adresse korrekt einträgst. Abweichungen (z. B. http\:// statt https\:// können zu Fehlern bei der Verarbeitung der Webhooks führen.
{% endhint %}

4. **Webhooks:** Definiere, ob ein fehlgeschlagener Webhook erneut ausgeführt werden soll oder nicht. Ist die Checkbox aktiviert, wird bis zu 10 Mal versucht, den Webhook erneut zu versenden. Die Abstände der Versuche betragen 5 Minuten, 15 Minuten, 1 Stunde, 2 Stunden, 4 Stunden und danach jeweils 24 Stunden.
5. **Abschliessen:** Klicke auf den grünen Button "Aktivieren", um die Konfiguration abzuschliessen.

### Installation des Plugins

* Lade die neueste Version des Plugins von [GitHub](https://github.com/payrexx/prestashop-payrexx-gateway) herunter:

<div align="left"><figure><img src="/files/pud3K1DyNRf2CURiTFa7" alt=""><figcaption><p>Herunterladen der ZIP-Datei von GitHub</p></figcaption></figure></div>

* Entpacke die Datei *prestashop-payrexx-gateway-master.zip*.
* Öffne den Ordner, in dem sich der Unterordner *payrexx* und die Datei *.gitignore* befinden.
* Komprimiere den Ordner *payrexx* zu einer ZIP-Datei.
* Logge Dich in Dein Konto bei PrestaShop ein.
* Navigiere zu **Module > Module Manager**.
* Klicke auf die Schaltfläche <img src="/files/TfpjR4hYpPV2ZsBQzsjR" alt="" data-size="line">.
* Lade die ZIP-Datei des Plugins hoch.

### Konfiguration von PrestaShop

* Navigiere zu **Module > Modul-Verwaltung**.
* Setze im Feld "Kategorie" den Filter "Payment":

<div align="left"><figure><img src="/files/p1yWuf1tggjSc4bkzCaT" alt=""><figcaption><p>Anzeigen der Payment-Module</p></figcaption></figure></div>

* Scrolle hinunter zu Payrexx und klicke auf "Einstellungen":

<div align="left"><figure><img src="/files/He2AJQfxiBZfr27i0WFU" alt=""><figcaption><p>Aufrufen der Einstellungen zum Modul von Payrexx</p></figcaption></figure></div>

PrestaShop kann auf zwei Arten mit Payrexx verbunden werden – automatisch oder manuell:

**PrestaShop automatisch mit Payrexx verbinden**

* Klicke auf die Schaltfläche "Connect With Platform", um die Verbindung zu Payrexx herzustellen:

<div align="left"><figure><img src="/files/AXNJcHJIGTkdj0kDoSsN" alt=""><figcaption><p>Automatisches Verbinden von PrestaShop und Payrexx</p></figcaption></figure></div>

**PrestaShop manuell mit Payrexx verbinden**

* Fülle die folgenden Felder aus, um die Verbindung zu Payrexx manuell herzustellen:

<div align="left"><figure><img src="/files/Qq4LhkOIe01k3kgq25NG" alt=""><figcaption><p>Manuelles Verbinden von PrestaShop und Payrexx</p></figcaption></figure></div>

1. **Payment Plattform:** Wähle die Plattform, auf der sich Dein Payrexx-Konto befindet.
2. **API Secret:** Füge den API-Schlüssel ein, der während der [Konfiguration von Payrexx](#konfiguration-von-payrexx) generiert wurde.
3. **Instance Name:** Erfasse den Instanznamen Deines Payrexx-Kontos. Der Instanzname entspricht dem ersten Teil Deiner Payrexx-URL. Wenn die URL *beispiel*.payrexx.com ist, so lautet der Instanzname *beispiel*.
4. **Look & Feel Profile ID:** Erfasse optional die ID des gewünschten [Look & Feel Profils](/merchant/payrexx-administration/einstellungen/look-and-feel.md).

Klicke ganz unten auf der Seite auf "Save", um die Verbindung herzustellen.

{% hint style="success" %}
Die Verbindung zwischen Payrexx und PrestaShop ist erfolgreich hergestellt.
{% endhint %}

* Navigiere zu **Erweiterte Einstellungen > Leistung**.
* Stelle sicher, dass im Abschnitt "Smarty" neben "Template-Kompilierung" die Option "Templates nach Datei-Änderungen neu kompilieren" ausgewählt ist:

<div align="left"><figure><img src="/files/OdOVvOcvDu7Kp0YnkvgN" alt=""><figcaption><p>Einstellungen zur Template-Kompilierung in PrestaShop</p></figcaption></figure></div>

### Konfiguration der Zahlungsmethoden

In diesem Abschnitt erfährst Du, wie Du in PrestaShop festlegst, mit welchen Zahlungsmethoden Deine Kunden im Shop bezahlen können.

* Navigiere zu **Module > Module Manager**.
* Scrolle bis zum Abschnitt "Payment Methods" hinunter.
* Lege fest, welche Zahlungsmittel Du aktivieren möchtest:

<div align="left"><figure><img src="/files/VLEzWVAsKjPfdMQig9yT" alt=""><figcaption><p>Verwaltung der Zahlungsmittel in PrestaShop</p></figcaption></figure></div>

## Bestellung aus Kundensicht

Der folgende Ablauf zeigt die Bestellung und Bezahlung eines Produkts durch einen Kunden auf einer Webseite mit PrestaShop und integrierter Zahlungslösung von Payrexx:

Der Kunde wählt ein Produkt aus und legt es in den Warenkorb:

<div align="left"><figure><img src="/files/volqbl5uOCauuJXRUKIH" alt=""><figcaption><p>Auswahl des Produkts "Hummingbird printed sweater"</p></figcaption></figure></div>

Der Kunde klickt auf die Schaltfläche "Zur Kasse":

<div align="left"><figure><img src="/files/zYT2HPZ2irZe1NExhHai" alt=""><figcaption><p>Weiter zur Kasse</p></figcaption></figure></div>

Der Kunde füllt die benötigten Felder aus und akzeptiert die allgemeinen Geschäftsbedingungen und den Datenschutzhinweis:

<div align="left"><figure><img src="/files/YlBMy3gQ3yT6BxQGRSbT" alt=""><figcaption><p>Ausfüllen der Formularfelder und Annahme der allgemeinen Geschäftsbedingungen</p></figcaption></figure></div>

Der Kunde wählt unterhalb von "Zahlung" die Option "Payrexx", worauf die in Payrexx aktivierten Zahlungsmethoden erscheinen – im folgenden Beispiel [Mastercard](/merchant/bezahldienste/payrexx-pay/zahlungsmittel/mastercard.md), [Visa](/merchant/bezahldienste/payrexx-pay/zahlungsmittel/visa.md), [Rechnung](/merchant/bezahldienste/payrexx-pay/zahlungsmittel/kauf-auf-rechnung.md) und [TWINT](/merchant/bezahldienste/payrexx-pay/zahlungsmittel/twint.md):

<div align="left"><figure><img src="/files/w4w2PpYhP20Azrnay9vQ" alt=""><figcaption><p>Auswahl von Payrexx</p></figcaption></figure></div>

Der Kunde schliesst die Bestellung auf der Website ab, indem er:

1. eine der verfügbaren Zahlungsmethoden auswählt (z. B. Visa).
2. die allgemeinen Geschäftsbedingungen akzeptiert.
3. auf "Bestellen" klickt.

<div align="left"><figure><img src="/files/sydCk3yvqyu1UOJEuKr4" alt=""><figcaption><p>Auswahl der Zahlungsmethode Visa</p></figcaption></figure></div>

Danach wird der Kunde zu Payrexx weitergeleitet, wo er die Bestellung abschliesst:

<div align="left"><figure><img src="/files/2CefIXQd8OS2D9mvH4CN" alt="" width="283"><figcaption><p>Abschluss der Bestellung bei Payrexx</p></figcaption></figure></div>

Nach Abschluss der Bestellung wird der Kunde auf die Website zurückgeleitet, wo die Bestell- und Zahlungsbestätigung angezeigt wird:

<div align="left"><figure><img src="/files/XMk3poKebXoAAq9MxdF7" alt=""><figcaption><p>Anzeige der Bestellbestätigung im Webshop</p></figcaption></figure></div>

{% hint style="success" %}
Die Bestellung ist damit erfolgreich abgeschlossen.
{% endhint %}

### Eigene Testbestellung durchführen

Falls Du selbst sehen möchtest, wie eine Bestellung aus Kundensicht abläuft, besuche unseren [Demo-Shop](https://showcase.payrexx.com/prestashop/de/) und führe eine Test-Bestellung durch.

Weitere Informationen und Test-Kreditkartendaten findest Du im folgenden Artikel:

{% content-ref url="/pages/-MdNQfj00UdAQ7WRckob" %}
[Testen](/merchant/zahlungen/testen.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/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.
