# QuinBook

## General Information

The QuinBook booking and management software has been specifically designed for escape rooms and other leisure activity providers.

With QuinBook, you can manage bookings, tickets, and vouchers, as well as schedule staff and resources.

### Links

* QuinBook [Website](https://quinbook.com/)

### Features

* ✅ Process payments directly within the booking workflow
* ✅ Handle refunds through the system

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

## Setup

The following chapters will guide you on how to integrate the Payrexx payment solution into QuinBook.

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

* Navigate to **API & Plugins** in the main menu of your merchant administration.
* 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%2Fqbp8R4kv9ee2Y2ChnOMq%2Fimage.png?alt=media&#x26;token=171107eb-6277-4601-ac32-463d7be797d6" alt=""><figcaption><p>Adding an API Key in Payrexx</p></figcaption></figure></div>

* Assign a name to the integration, for example "QuinBook".
* Click on 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%2F6SJtyf04avhaIeo5tG7V%2Fimage.png?alt=media&#x26;token=07aa9f97-e16a-4ec8-9787-26484df45b2c" alt="" width="563"><figcaption><p>Creating the API Key in Payrexx</p></figcaption></figure></div>

#### Copying the API Key

* Navigate again to **API & Plugins**.
* Click "Copy" next to the previously created QuinBook integration to copy the API Key to your clipboard. You will need it in a later step:

<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%2FEpD3ATC1ujLmqAuLColK%2Fimage.png?alt=media&#x26;token=071ff282-4425-42bd-8a8a-24e899df7fbe" alt=""><figcaption><p>Copying the API Key to the clipboard</p></figcaption></figure></div>

#### Creating a Webhook

* Navigate to **Webhooks** in the main menu of your merchant administration.
* Click "Add Webhook".
* Configure the webhook according to the following instructions:

<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%2FeUcARffgxs7zKSujQjmR%2Fimage.png?alt=media&#x26;token=673454da-b687-48ad-8cc2-fad7539e4fb3" alt="" width="563"><figcaption><p>Configuring the webhook for QuinBook in Payrexx</p></figcaption></figure></div>

1. **Name:** Assign any name, for example, “QuinBook”.
2. **Webhook URL:** Enter the following URL: <https://quinbook.com/HandlePayrexxWebhook>
3. **Events:** Enable all four checkboxes.
4. **Webhook Type and Version:** Select "JSON" as the content type and "2022-11-29" as the webhook version.

Click the "Add" button to save your changes.

### Configuration of QuinBook

* Log in to your QuinBook account.
* Go to the following URL: <https://quinbook.com/Seller/Home#SettingsShop/_SettingsShopPayments>
* Scroll down to the "Payrexx Connection" section and enter the following information from Payrexx into the corresponding fields:

<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%2FXyaEbfIxUT5LSwkKIWeU%2Fimage.png?alt=media&#x26;token=364f8fdc-483f-4667-a91c-9760509970f3" alt=""><figcaption><p>Creating the connection to Payrexx in QuinBook</p></figcaption></figure></div>

1. **Instance Name:** Enter the instance name of your Payrexx account. If your payment page URL is *example*.payrexx.com, your instance name is *example*.
2. **API Key:** Paste the API key you [previously](#copying-the-api-key) copied to your clipboard.

Click the green "Connect with Payrexx" button.

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