# API und Integrationen

Die Abkürzung "API" steht für Application Programming Interface. Man versteht darunter einen Satz von Befehlen, Funktionen und Protokollen, mit dem eine Software mit einem anderen System interagieren kann.

## Erstellen einer Integration mittels Plugin

Für die folgenden Drittsysteme bestehen Plugins, mit denen Du die Integration automatisch vornehmen kannst. Klicke auf den jeweiligen Link, um die Anleitung zur Integration aufzurufen:

|                                                                                     |                                                                                     |                                                                                                     |
| ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| [WooCommerce](https://docs.payrexx.com/merchant/integration/e-commerce/woocommerce) | [MyCommerce](https://docs.payrexx.com/merchant/integration/e-commerce/mycommerce)   | [Odoo](https://docs.payrexx.com/merchant/integration/e-commerce/odoo)                               |
| [Shopify](https://docs.payrexx.com/merchant/integration/e-commerce/shopify)         | [Ecwid](https://docs.payrexx.com/merchant/integration/e-commerce/ecwid)             | [Concrete 5](https://docs.payrexx.com/merchant/integration/content-management-system-cms/concrete5) |
| [Shopware 6](https://docs.payrexx.com/merchant/integration/e-commerce/shopware-6)   | [Gambio](https://docs.payrexx.com/merchant/integration/e-commerce/gambio)           | [Cloudrexx](https://docs.payrexx.com/merchant/integration/content-management-system-cms/cloudrexx)  |
| [Shopware 5](https://docs.payrexx.com/merchant/integration/e-commerce/shopware-5)   | [JTL Shop 5](https://docs.payrexx.com/merchant/integration/e-commerce/jtl-shop)     | [saldiaShop](https://docs.payrexx.com/merchant/integration/e-commerce/saldiashop)                   |
| [Magento 2](https://docs.payrexx.com/merchant/integration/e-commerce/magento-2)     | [nopCommerce](https://docs.payrexx.com/merchant/integration/e-commerce/nopcommerce) | [Drupal](https://docs.payrexx.com/merchant/integration/content-management-system-cms/drupal)        |
| [PrestaShop](https://docs.payrexx.com/merchant/integration/e-commerce/prestashop)   |                                                                                     |                                                                                                     |

Weitere Informationen zur Anbindung an Softwarelösungen findest Du in den folgenden Artikeln:

{% embed url="<https://docs.payrexx.com/merchant/integration/e-commerce>" %}

{% content-ref url="../integration/content-management-system-cms" %}
[content-management-system-cms](https://docs.payrexx.com/merchant/integration/content-management-system-cms)
{% endcontent-ref %}

{% content-ref url="../integration/unternehmenssoftware" %}
[unternehmenssoftware](https://docs.payrexx.com/merchant/integration/unternehmenssoftware)
{% endcontent-ref %}

## Erstellen einer Integration über die API

{% hint style="info" %}
Bitte stelle sicher, dass Du die aktuelle API-Version 1.13 von Payrexx nutzt.
{% endhint %}

Falls Du ein System verwendest, für das kein Plugin existiert, kannst Du die Integration über unsere API manuell vornehmen. Navigiere hierfür in der Händler-Administration Deines Payrexx-Kontos zu **API und Integrationen**.

* Klicke auf "API-Schlüssel hinzufügen", um eine neue Integration über die API zu erstellen:

<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%2F7JVg2uj7bYpKlugAJ413%2Fimage.png?alt=media&#x26;token=c1227307-cedd-43fb-ad20-b18f6910f3ba" alt=""><figcaption><p>Erstellen eines API-Schlüssels in Payrexx</p></figcaption></figure></div>

* Gib der Integration einen beliebigen Namen (1) und klicke auf "Hinzufügen" (2):

<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%2FFOw8TCLvJdK7waXMKGhc%2Fimage.png?alt=media&#x26;token=1ebed063-60d9-4ed3-80c4-b0c18006b3c1" alt="" width="563"><figcaption><p>Vergabe des Namens und Erstellen des Schlüssels</p></figcaption></figure></div>

* Sobald der API-Schlüssel erstellt ist, findest Du ihn unter **API und Integrationen** in der Liste, wo die folgenden Funktionen zur Verfügung stehen:

<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%2FEC6KgjixTS2irJtN59E5%2Fimage.png?alt=media&#x26;token=fc6678c2-27d5-472a-aa0b-709fde1ac72b" alt=""><figcaption><p>Der erstellte API-Schlüssel in der Liste</p></figcaption></figure></div>

1. **Kopieren:** Kopiert den Wert des API-Schlüssels in die Zwischenablage.
2. **Logs:** Zeigt eine Liste sämtlicher [Log-Einträge](#anzeigen-der-log-files) dieses API-Schüssels an:
3. **Konfiguration:** Öffnet den API-Schlüssel im Bearbeitungsmodus, wo Du den Namen ändern oder den Schlüssel neu generieren kannst.

## Anzeigen der Log-Files

Zu jeder API-Integration, sei es über ein Plugin oder manuell über die API, gibt es Log-Files, in denen alle API-Anfragen zwischen Payrexx und dem jeweiligen Drittsystem aufgezeichnet und allfällige Fehler angezeigt werden. Gehe wie folgt vor, um das Log-File anzusehen:

* Navigiere in der Händler-Administration zu **API und Integrationen**.
* Klicke beim gewünschten Eintrag auf "Logs":

<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%2FZuwSUvQ6jPgkoZBDSkOb%2Fimage.png?alt=media&#x26;token=50558cdc-4c46-4db8-8a1d-827879a4ea12" alt=""><figcaption><p>Aufrufen des Log-Files einer über das Plugin erstellten Integration in WooCommerce</p></figcaption></figure></div>

<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%2FJFzyxBE08c1c1b91zJvu%2Fimage.png?alt=media&#x26;token=fc6f3bcb-b993-4079-a013-1b551bd9475c" alt=""><figcaption><p>Aufrufen des Log-Files einer manuell erstellten Integration</p></figcaption></figure></div>

Du siehst nun eine Liste der API-Anfragen zwischen Payrexx und dem gewählten E-Commerce-System, im folgenden Beispiel [PrestaShop](https://docs.payrexx.com/merchant/integration/e-commerce/prestashop):

<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%2F3b02wYpEsIxd4O66xNJg%2Fimage.png?alt=media&#x26;token=02df5bc4-0298-49af-b1ae-46e7b45c7fd8" alt="" width="543"><figcaption><p>Auszug aus der Liste der API-Anfragen</p></figcaption></figure></div>

Durch einen Klick in die jeweilige Zeile öffnet sich im rechten Bereich des Fensters die Detailansicht zur gewählten API-Anfrage, hier am Beispiel einer Integration mit [Shopware 6](https://docs.payrexx.com/merchant/integration/e-commerce/shopware-6):

<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%2FGbWWxwSJy5eb0qPT78WD%2Fimage.png?alt=media&#x26;token=1f315a04-4a56-42e9-931e-7ddcced324e2" alt=""><figcaption><p>Beispiel einer API-Anfrage der Integration mit Shopware 6</p></figcaption></figure></div>

## Weitere Informationen zur API

In der Entwickler-Dokumentation von Payrexx findest Du weitere Informationen zu API:

{% content-ref url="<https://app.gitbook.com/o/-MZDN-2GEQ0T0koFERUS/s/-McsA9Ay7RplF5hVbrkE/>" %}
[Developer](https://app.gitbook.com/o/-MZDN-2GEQ0T0koFERUS/s/-McsA9Ay7RplF5hVbrkE/)
{% endcontent-ref %}