# Drupal

{% hint style="info" %}
Verfügbar für Drupal 9.x und 10.x
{% endhint %}

## Allgemein

Drupal ist ein modulares Open Source Content-Management-System (CMS), mit dem Unternehmen Webseiten erstellen und verwalten können. Durch die Integration von Payrexx in Drupal können Händler in ihrem Webshop Zahlungen ihrer Kunden empfangen.

### Links

* [Webseite](https://www.drupal.org) von Drupal
* Download des [Plugins](https://www.drupal.org/project/commerce_payrexx_integration/releases/2.0.1)
* [Installationsanleitung](https://www.drupal.org/project/commerce_payrexx_integration) des Plugins

## Setup

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

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

### 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 Drupal auf "Hinzufügen":

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2Fjf6JGmzkn2NbOFYmFIA9%2Fimage.png?alt=media&#x26;token=58903f97-13e4-48e9-8ad9-d5315d2979b1" alt=""><figcaption><p>Start der Integration von Payrexx und Drupal</p></figcaption></figure></div>

* Nimm im untenstehenden Fenster die folgenden Einstellungen vor:

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FNkxscO8OcBVxW24UJJtG%2Fimage.png?alt=media&#x26;token=dee4f185-7f79-403b-a640-01c05379f1d6" alt=""><figcaption><p>Konfiguration der Anbindung von Drupal 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

* Installiere das Modul mit dem folgenden Befehl: `composer require drupal/commerce_payrexx_integration`.
* Aktiviere das Modul mit dem Befehl `drush en commerce_payrexx_integration`.

### Konfiguration des Moduls

* Erstelle unter **/admin/commerce/config/payment-gateways** das Zahlungs-Gateway.
* Wähle als Plugin "Payrexx (Redirect to Payrexx)" aus.
* Fülle sämtliche erforderliche Felder aus. Füge dabei die bei der [Konfiguration von Payrexx](#konfiguration-von-payrexx) in die Zwischenablage kopierten Werte in die entsprechenden Felder ein:
  * den Instanzmanen ins Feld "Instance Name"
  * den API-Schlüssel ins Feld "Secret"

{% hint style="success" %}
Die Konfiguration ist abgeschlossen. Deine Kunden können im Shop von Magento 2 mit den Zahlungsmitteln aus Payrexx bezahlen.
{% endhint %}