# Planyo

## General Information

Planyo is a Swiss online booking system that enables efficient management of bookings and reservations for holiday rentals, conference rooms, rental vehicles, medical appointments, sports facilities, and many other services.

Planyo can be easily integrated into existing websites and offers over 100 interfaces to cloud services, CRM systems, and accounting tools. By connecting to Payrexx, customers can make bookings online and pay directly through the Payrexx payment solution.

### Links

* [Log in](https://www.planyo.com/login/login.php) to Planyo
* [Register](https://www.planyo.com/login/signup.php) with Planyo
* Planyo [Website](https://www.planyo.com/)
* Planyo [Demo](https://www.planyo.com/learn-more.php)

### Features

* ✅ Payment functionality in the booking process
* ✅ Full payment and deposits
* ✅ Bookings with or without payment

{% hint style="info" %}
Please note that integration with Planyo is only available in the Standard and Premium plans. [For more information](https://payrexx.com/en/prices)
{% endhint %}

## Setup

In the following sections, you will learn how to integrate the Payrexx payment solution into Planyo.

### Configuration of Payrexx

{% hint style="info" %}
Make sure you're [logged in](https://login.payrexx.com/) to your Payrexx account before you begin. If you don’t have a Payrexx account yet, you can [register](https://signup.payrexx.com/) now.
{% endhint %}

#### Creating an API Key

* In the main menu of your merchant administration, navigate to **API & Plugins**.
* Scroll down to "Add API Integration" and click "Add API Key":

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FpvxBZVamgDnGh6sQZFtg%2Fimage.png?alt=media&#x26;token=f3e0f0e0-abfc-4058-9511-5dfe004ee236" alt=""><figcaption><p>Adding an API Key in Payrexx</p></figcaption></figure></div>

* Assign any name to the integration, for example "Planyo".
* Click the green "Add" button:

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FrCroda2p8n8Ky2ciuCC9%2Fimage.png?alt=media&#x26;token=019e2363-efd9-4a19-aca1-69e4e86331a7" alt="" width="563"><figcaption><p>Creating the API Key in Payrexx</p></figcaption></figure></div>

#### Creating a webhook

To enable Payrexx to send transaction notifications to Planyo, you need to create a corresponding webhook in Payrexx:

* In the main menu of your Payrexx account, navigate to **Webhooks**.
* Click "Add Webhook".
* Configure the webhook according to the example shown below:

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2F689LXbMw5dJ1EtEnKB2B%2Fimage.png?alt=media&#x26;token=59e93f9b-a4d9-4211-8789-55f8c4a348a6" alt="" width="563"><figcaption><p>Webhook configuration in Payrexx</p></figcaption></figure></div>

1. **Name:** Assign any name to the webhook, for example, “Planyo.”
2. **Webhook URL:** Ensure that the webhook URL is exactly *<https://www.planyo.com/payment-payrexx-ipn.php>*.
3. **Webhook Type:** Select the format "JSON".

Click the "Add" button to save the webhook.

### Configuration of Planyo

* Log in to the admin area of your Planyo account.
* In the main menu on the left-hand side, click **Quick Setup**.
* Scroll down to the "Online Payments" section.
* Apply the following settings:

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2F59Xi9Dd3QArELQiyNT9l%2Fimage.png?alt=media&#x26;token=efe450f8-1209-4888-acca-682ae2f5b1bc" alt="" width="563"><figcaption><p>Configuring the integration in Planyo</p></figcaption></figure></div>

1. **Payment Processing Site:** Select the option "Payrexx (CH)".
2. **Instance Name:** Enter the instance name of your Payrexx account. If the URL of your payment page is *example*.payrexx.com, your instance name is *example*.
3. **API Key:** Enter the [API key](#creating-an-api-key) you previously generated in Payrexx.
4. **Obligatory Paymen**t: Check this box if you want to allow bookings only when accompanied by an online payment
5. **Pre-Payment Amount:** Specify whether you want to require the full amount or a deposit at the time of booking.

Save your settings to complete the configuration.

{% hint style="success" %}
The integration of Payrexx into Planyo is now complete.
{% endhint %}