# saldiaShop

## General

The Swiss company saldia offers merchants the opportunity to easily create and operate their own online shop with its e-commerce solution, saldiaPay.

### Links

* Saldia [Website](https://www.saldia.ch/) (only available in German)

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

## Integration

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

* Navigate to **API & Plugins** in the merchant administration of your Payrexx account.
* Click on "Show all" below "Add E-commerce integration".
* Scroll down and click the "Add" button next to saldia:

<figure><img src="/files/9BigkCJ8Pq3l0tqKgOoF" alt=""><figcaption><p>Starting the setup of saldia in Payrexx</p></figcaption></figure>

* The following window will open:

<div align="left"><figure><img src="/files/61XQn2ScS1YNbSrfdQxI" alt=""><figcaption><p>Settings for integrating saldia with Payrexx</p></figcaption></figure></div>

1. **Configure**: The fields will display the automatically generated value for the API key and the name of your Payrexx instance. You will need these two values later when [configuring saldiaShop](#configuration-of-saldiashop).
2. **Enter shop address:** Enter the URL of your shop in this field. If your shop is not in the root directory (<https://my-shop.com>) but in a subdirectory, please enter the full path to your shop. Example: <https://my-shop.com/shop>

{% hint style="warning" %}
Please ensure that the shop URL is entered correctly. Any discrepancies (e.g. using http\:// instead of https\://) may cause errors when processing webhooks.
{% endhint %}

4. **Webhooks:** Define whether a failed webhook should be retried. If the checkbox is selected, the system will attempt to resend the webhook up to 10 times. The retry intervals are 5 minutes, 15 minutes, 1 hour, 2 hours, 4 hours, and then every 24 hours thereafter.
5. **Finalize:** Click the green "Activate" button to finish the configuration and save the settings.

### Configuration of saldiaShop

{% hint style="info" %}
Please note that the user interface of saldiaShop is only available in German.
{% endhint %}

* Log into your saldiaShop account.
* Navigate to **saldiaApps** in the main menu.
* To activate the Payrexx app, you must first deactivate the saldiaPay app. To do this, click "Bearbeiten" (English: Edit) below saldiaPay:

<div align="left"><figure><img src="/files/3kUyXx6van5qych2PcER" alt="" width="221"><figcaption><p>Editing the saldiaPay app</p></figcaption></figure></div>

* Click "App deaktivieren" (English: Deactivate App) and then "Bestätigen" (English: Confirm) in the next step:

<div align="left"><figure><img src="/files/eUoDBNWGwxMNznLW6hrU" alt="" width="563"><figcaption><p>Deactivating the saldiaPay app</p></figcaption></figure></div>

* Scroll down the list and click "Hinzufügen" (English: Add) next to the Payrexx app:

<div align="left"><figure><img src="/files/OZG8BeyUqCzkCCe1yDLn" alt="" width="563"><figcaption><p>Adding the Payrexx app in saldiaShop</p></figcaption></figure></div>

* In the next window, click the green "Kaufen" (English: Purchase) button:

<div align="left"><figure><img src="/files/tT3nnpEmjtWulh8xH0rL" alt="" width="375"><figcaption><p>Creating the Payrexx app in saldiaShop</p></figcaption></figure></div>

* Enter the instance name and API key from [Payrexx](#configuration-of-payrexx) into the corresponding fields "Instanzname" and "API Schküssel" and click "Änderungen speichern" (English: Save Changes):

<div align="left"><figure><img src="/files/Zu0HkV9Nw8jRijAPwmBE" alt="" width="563"><figcaption><p>Entering instance name and API Key in saldiaPay</p></figcaption></figure></div>

{% hint style="success" %}
The configuration is now complete. Payrexx has been successfully integrated into saldiaShop.
{% 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/e-commerce/saldiashop.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.
