# 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 %}


---

# 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/content-management-system-cms/drupal.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.