# Reservation System (Hürlimann Informatik)

## General

The Hürlimann Informatik reservation system allows for the management and online reservation of rooms and equipment. The web application is offered as a full-service solution, including maintenance and support services. Through the appropriate integration, customers can make payments via the Payrexx payment solution.

### Links

* [Hürlimann Informatik](https://www.hi-ag.ch/) Website
* Information about the [Reservation System](https://www.hi-ag.ch/reservationssystem)

## Features

* ✅ Simultaneous display of calendars for multiple objects
* ✅ Recurring reservations (daily, weekly, or annually)
* ✅ Real-time synchronization of reservations with the calendar
* ✅ Reservations as a registered user or guest
* ✅ Payments via the Payrexx payment solution

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

<figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FU4jh35aSz39vZEw6ohU9%2Fimage.png?alt=media&#x26;token=21516026-fe7e-49f5-921a-156cbfd43193" alt=""><figcaption><p>Screenshots from the Hürlimann Informatik Reservation System</p></figcaption></figure>

## Integration

In the following chapters, you will learn how to integrate the Payrexx payment solution into the Hürlimann Informatik reservation system.

### 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 your merchant administration main menu, navigate to **API & Plugins**.
* Scroll down to "Add API Integration" and click on "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%2FlMsMxGV1otCNIjtPnKmE%2Fimage.png?alt=media&#x26;token=dcd457ed-8780-4700-a3d8-a8c55cea9e5a" alt=""><figcaption><p>Adding an API Key in Payrexx</p></figcaption></figure></div>

* Provide a name for the integration, for example, "Reservation System".
* Click on "Add":

<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%2F3k7NYAmBB4IaIMgqPgf1%2Fimage.png?alt=media&#x26;token=c06a1f89-b8a0-4ea4-9593-b799882a7d06" alt="" width="563"><figcaption><p>Creating an API Key in Payrexx</p></figcaption></figure></div>

#### Adding a webhook

1. In your merchant administration main menu, navigate to **Webhooks**.
2. Click on **Add webhook**.
3. Configure the webhook using the following example:

<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%2FInB8eFP7WX5cfdtbHP4u%2Fimage.png?alt=media&#x26;token=23233bec-5d62-4c7f-9946-ac2a8e4ba0ec" alt="" width="563"><figcaption><p>Configuring the webhook in Payrexx</p></figcaption></figure></div>

1. **Name**: Give the webhook a name, for example, "Reservation System".
2. **Webhook URL**: Enter the webhook URL that you find in the reservation system under **Payment > Payment Providers > Webhooks**.
3. **Events**: Check all four checkboxes.
4. **Webhook Type and Version**: Select "JSON" as the content type and "2021-10-12" as the webhook version.

Complete the configuration by clicking on "Add".

#### Entering a Technical Contact

* In your merchant administration main menu, navigate to **Webhooks**.
* On the right side of the window, enter a technical contact based on the following example:

<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%2FRntTIHZd9zdoXpBNBPFI%2Fimage.png?alt=media&#x26;token=34b11ca5-cc63-4a50-903e-0acac964040d" alt="" width="213"><figcaption><p>Entering the technical contact</p></figcaption></figure></div>

1. **Name**: Use the name "HiAG Web Admin".
2. **Mail**: Enter the email address that you find in the reservation system under **Bezahlwesen > Bezahlanbieter > Technischer Kontakt**.

### Configuration of the Reservation System

{% hint style="info" %}
Before you can begin the configuration, you need to order the "Online Payments" add-on module from Hürlimann Informatik. Please [contact](https://www.hi-ag.ch/reservationssystem) a sales representative for assistance.
{% endhint %}

Once the module is activated, you can proceed with its configuration.

* Log into the Reservation System.
* Navigate to **Bezahlwesen > Bezahlanbieter** and follow the steps in the instructions below.

#### Step 2: Anbieter

* Select Payrexx as the provider and click on "Next".

<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%2F4R8FgH601p4LCAkUAKuc%2Fimage.png?alt=media&#x26;token=f2f1fa9e-2c33-48ee-9188-d447080b93ef" alt=""><figcaption><p>Selecting Payrexx as the payment provider in the Reservation System</p></figcaption></figure></div>

#### Step 3: Instanz

* Enter the name of your Payrexx instance:

<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%2FoJg1e3cZ7SBrn75Apn4R%2Fimage.png?alt=media&#x26;token=0317bf9d-f29e-46e0-8d2c-e8847123726a" alt=""><figcaption><p>Entering the instance from Payrexx in the corresponding field</p></figcaption></figure></div>

* You can find the instance name in your Payrexx account under **Settings > General Settings**, below "Domain". The instance is the string between https\:// and payrexx.com. In the following example, the instance name is "demo":

<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%2FAD9097AWtPVtSPVadwPJ%2Fimage.png?alt=media&#x26;token=d474f2cf-dbd5-4986-bf60-d08abc755e8c" alt="" width="290"><figcaption><p>Display of the instance name in Payrexx</p></figcaption></figure></div>

#### Step 4: API-Schlüssel

* Enter the value of the API Key created in Payrexx:

<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%2FznXZATanLqxJ6yElJvj7%2Fimage.png?alt=media&#x26;token=512b55b6-ffbd-4cb0-ab2f-f1808704f694" alt=""><figcaption><p>Entering the API Key from Payrexx in the corresponding field</p></figcaption></figure></div>

* You can find the API key in your Payrexx account under **API & Plugins**, where you can copy it to your clipboard:

<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%2FMXHrw9pOOwXbEQqdl2Zn%2Fimage.png?alt=media&#x26;token=16932fbb-3d2e-4816-ba3c-03fb3e5fbce0" alt=""><figcaption><p>Copying the API Key to the clipboard</p></figcaption></figure></div>

#### Step 7: Abschluss

* Click on "Konfiguration speichern" to save your 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%2FCgU7q2hvegA7EYlv0ClM%2Fimage.png?alt=media&#x26;token=9698c4ad-6259-417b-a19e-ec774a6139a6" alt=""><figcaption><p>Completion of the configuration in the Hürlimann Informatik Reservation System</p></figcaption></figure></div>

{% hint style="success" %}
The integration of Payrexx into the Hürlimann Informatik reservation system is complete.
{% endhint %}