# Cloudrexx

## General

Cloudrexx is a proprietary Content Management System that offers designs and modules for content management, e-commerce, event management, as well as tools for SEO and social media integration.

### Links

* Cloudrexx [Website](https://www.cloudrexx.com/)
* Cloudrexx [Login](https://my.cloudrexx.com/)

## Integration Using Plugin

Use the following instructions to integrate Payrexx into Cloudrexx using a plugin.

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

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

* In the main menu of your Payrexx account, navigate to **API & Plugins**.
* Click on "Add" next to Cloudrexx:

<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%2FRZF59in9D9O20ONUJgB4%2Fimage.png?alt=media&#x26;token=f8e955a3-6763-4e98-b6ba-663449664a2a" alt=""><figcaption><p>Starting the integration in Cloudrexx via the plugin</p></figcaption></figure></div>

* Configure the integration as described 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%2FJotOJGzca9iEvsPv7P1X%2Fimage.png?alt=media&#x26;token=55cfdca4-1f23-45f8-991d-68ae068713c3" alt=""><figcaption><p>Settings for integrating Payrexx into Cloudrexx</p></figcaption></figure></div>

1. **API Key:** Copy the API key displayed in this field, navigate to your Cloudrexx account to **Shop > Settings > Payment Methods**, click on "Edit" for Payrexx, and paste the API key into the "API Secret" field.
2. **Instance name:** Copy the instance name displayed in this field, navigate to your Cloudrexx account to **Shop > Settings > Payment Methods**, click on "Edit" for Payrexx, and paste the instance name into the "Instance" field.
3. **Shop address:** Enter the URL of your shop. If the shop is located in a subdirectory, link to it accordingly. For example, it could be <https://demo-shop.ch/> or <https://demo-shop.ch/shop>.
4. **Webhooks:** Define whether a failed webhook should be retried or not. If the checkbox is selected, the webhook will be retried up to 10 times. The retry intervals are 5 minutes, 15 minutes, 1 hour, 2 hours, 4 hours, and then every 24 hours.
5. **Activate:** Click on "Activate" after completing steps 1 to 4.

{% hint style="success" %}
Payrexx is successfully integrated into Cloudrexx.
{% endhint %}

## Integration Using Webhook

If you wish to manually integrate Payrexx into Cloudrexx via a webhook, follow the steps outlined below.

### Configuration of Payrexx

{% hint style="info" %}
Make sure you are [logged in](https://login.payrexx.com/en) to Payrexx to get started. If you don’t have a Payrexx account yet, you can [register](https://signup.payrexx.com/en/email-validation/) now.
{% endhint %}

In the main menu of your Payrexx account, navigate to **Webhooks** and click on "Add webhook":

<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%2Fd1mY0zPP4Aqbz4LPTq4e%2Fimage.png?alt=media&#x26;token=bc4456af-1dff-41ee-8e65-f63385e7e126" alt="" width="563"><figcaption><p>Adding a new webhook in Payrexx</p></figcaption></figure></div>

Configure the webhook by making 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%2FGkSOlrhfxnqL84pMNpsU%2Fimage.png?alt=media&#x26;token=bf88179a-8d1c-47c9-b31b-991953a05ef9" alt="" width="563"><figcaption><p>Configuring the webhook in Payrexx</p></figcaption></figure></div>

1. **Name:** Enter any name, for example, "Integration Cloudrexx". This field is optional.
2. **Webhook URL:** Enter the URL of your Cloudrexx website in the following format: <https://www.example.com/en/index.php?section=Shop\\&cmd=success\\&handler=payrexx\\&result=-1>
3. **Add:** Click the green button to save your settings.

{% hint style="success" %}
The remaining settings do not need to be changed and can be left as shown in the screenshot above.
{% endhint %}

### Configuration of Cloudrexx

{% hint style="info" %}
[Log in](https://my.cloudrexx.com/) to your Cloudrexx account to begin the integration.
{% endhint %}

In the main menu of your Cloudrexx account, navigate to **Shop > Settings > Payment Methods**:

<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%2FbFNsSdIRelmxEgbaRueG%2Fimage.png?alt=media&#x26;token=7849d2fc-1150-41d8-95e4-aff06f2216de" alt=""><figcaption><p>Adding payment methods in Cloudrexx</p></figcaption></figure></div>

Enable the two checkboxes for the payment provider "Payrexx" under "Details" and "Active":

<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%2F8ovwagXqCrtEdWFVrnfK%2Fimage.png?alt=media&#x26;token=0de87a62-6075-4e46-81c4-c8c279109236" alt=""><figcaption><p>Activating the Payrexx payment provider</p></figcaption></figure></div>

Set up the Payrexx payment provider by making 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%2FTuTzGZvmAx63BV5CO9pL%2Fimage.png?alt=media&#x26;token=4994cb79-7ad6-4968-8bc1-1ee0696bf4d4" alt=""><figcaption><p>Configuring the Payrexx payment provider</p></figcaption></figure></div>

1. **Instance:** Enter the name of your Payrexx [instance](https://docs.payrexx.com/merchant/english/account/dashboard).
2. **Domain:** Enter the name of your Payrexx domain. Alternatively, you can enter payrexx.com or leave the field blank.
3. **API Secret:** Enter the API key, which you can find in the Payrexx backend under **API & Plugins**.

Then click "Save" to complete the configuration.

{% hint style="success" %}
Payrexx has been successfully integrated into Cloudrexx.
{% endhint %}