# Planyo

## Allgemein

Mit dem Schweizer Online-Buchungsystem Planyo können Buchungen und Reservationen von Ferienwohnungen, Konferenzräumen, Mietfahrzeugen, Arztterminen, Sporteinrichtungen und vielen weiteren Dienstleistungen effizient verwaltet werden.

Planyo kann einfach in bestehende Webseiten integriert werden. Es gibt zudem über 100 Schnittstellen zu Cloud-Diensten, CRM- und Buchhaltungssystemen. Durch die Anbindung an Payrexx können Kunden online buchen und direkt über die Zahlungslösung von Payrexx bezahlen.

### Links

* [Login](https://www.planyo.com/login/login.php) bei Planyo
* [Registrierung](https://www.planyo.ch/login/signup.php) bei Planyo
* [Webseite](https://www.planyo.ch/) von Planyo
* [Demo-Seiten](https://www.planyo.ch/learn-more.php) von Planyo

### Funktionen

* ✅ Bezahlfunktion im Buchungsprozess
* ✅ Gesamtbetrag und Anzahlungen
* ✅ Buchungen mit/ohne Bezahlung

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

## Integration

In den nächsten Kapiteln erfährst Du, wie Du die Zahlungslösung von Payrexx in Planyo integrierst.

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

#### Erstellen eines API-Schlüssels

* Navigiere im Hauptmenü Deiner Händler-Administration zu **API und Integrationen**.
* Scrolle hinunter zu "API-Integration hinzufügen" und klicke auf "API-Schlüssel 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%2FLuGgWYbJWxQiDQzvAcwj%2Fimage.png?alt=media&#x26;token=1bd4a4f8-3ad8-4ddb-b7eb-ef3ad88c15f2" alt=""><figcaption><p>Hinzufügen eines API-Schlüssels in Payrexx</p></figcaption></figure></div>

* Gib der Integration einen beliebigen Namen, zum Beispiel "Planyo".
* Klicke auf die grüne Schaltfläche "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%2Fr2GmlMleqmzh0c2PebGw%2Fimage.png?alt=media&#x26;token=38f0f04b-4ef3-41bb-b880-1faccbf0a10a" alt="" width="563"><figcaption><p>Erstellen der API-Schlüssels in Payrexx</p></figcaption></figure></div>

#### Erstellen eines Webhooks

Damit Payrexx Transaktions-Benachrichtigungen an Planyo senden kann, muss in Payrexx ein entsprechender Webhook erstellt werden:

* Navigiere im Hauptmenü Deines Payrexx-Kontos zu **Webhooks**.
* Klicke auf "Webhook hinzufügen".
* Konfiguriere den Webhook anhand der folgenden Abbildung:

<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%2Fxh07IA9Ws1084QaY4Jkx%2Fimage.png?alt=media&#x26;token=c1b8ebdf-cebb-44ec-919a-0fc1dcb75898" alt="" width="563"><figcaption><p>Konfiguration des Webhooks in Payrexx</p></figcaption></figure></div>

1. **Name:** Vergib für den Webhook einen beliebigen Namen, zum Beispiel "Planyo".
2. **Webhook URL:** Stelle sicher, dass die Webhook URL exakt *<https://www.planyo.com/payment-payrexx-ipn.php>* lautet.
3. **Webhook-Inhaltstyp:** Wähle das Format "JSON" aus.

Klicke auf die Schaltfläche "Hinzufügen", um den Webhook zu speichern.

### Konfiguration von Planyo

* Logge Dich in den Admin-Bereich Deines Kontos bei Planyo ein.
* Klicke im Hauptmenü auf der linken Seite auf **Schnelle Einrichtung**.
* Scrolle hinunter zum Abschnitt "Online-Zahlung".
* Nimm 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%2Fex0opSo9E8z2tsGYGzqQ%2Fimage.png?alt=media&#x26;token=30e97b45-779a-4667-9eb7-d9b1453069a7" alt="" width="563"><figcaption><p>Konfiguration der Integration bei Planyo</p></figcaption></figure></div>

1. **Payment Processing Site:** Wähle die Option "Payrexx (CH)" aus.
2. **Instance Name:** Füge den Instanznamen Deines Payrexx-Kontos ein. Wenn die URL Deiner Bezahlseite *beispiel*.payrexx.com ist, lautet Dein Instanzname *beispiel*.
3. **API Key:** Füge den [API-Schlüssel](#erstellen-eines-api-schlussels) ein, den Du zuvor in Payrexx generiert hast.
4. **Obligatory Payment:** Aktiviere das Kontrollkästchen, wenn Du Buchungen nur in Zusammenhang mit einer Online-Zahlung zulassen willst.
5. **Anzahlungsbetrag:** Lege fest, ob Du bei der Buchung den Gesamtbetrag oder eine Anzahlung verlangen möchtest.

Speichere Deine Einstellungen, um die Konfiguration abzuschliessen.

{% hint style="success" %}
Die Integration von Payrexx in Planyo ist abgeschlossen.
{% endhint %}