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


---

# 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/unternehmenssoftware/planyo.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.