# 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="/files/G9HNY0z7dzo1RywEGQxK" 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="/files/kdkr2EceB7pa7gtfAg8Y" 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="/files/O6iR2pZPXOHQzns59FND" 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="/files/bzK3oBVuvjqT8bdrRDv1" 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="/files/ighZqCYBZuu1SqLRpFO8" 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="/files/7rpXzhhGiX978ufTfEdF" 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="/files/bQ5AbhQPA3JCcIUfgii3" 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="/files/5ssiVtPoVtOWrE2RerUU" 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="/files/78cyBkADq4zJ2vQbzoHj" 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="/files/xnzRDXKGbTUknrA5ojc1" 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="/files/ftkZu3sHaRR8XyaO7cgJ" 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 %}


---

# 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/english/integration/business-software/reservation-system-hurlimann-informatik.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.
