# saldiaShop

## Allgemein

Das Schweizer Unternehmen saldia bietet mit seiner E-Commerce-Lösung saldiaPay Händlern die Möglichkeit, auf einfache Weise einen eigenen Webshop zu erstellen und zu betreiben.

### Links

* [Webseite](https://www.saldia.ch/) von saldia

{% hint style="info" %}
Bitte beachte, dass die Integration in saldiaShop nur in den Preisplänen "Standard" und "Premium" verfügbar ist. [Weitere Informationen](https://payrexx.com/de-ch/preise)
{% endhint %}

## Setup

### Konfiguration von Payrexx

{% hint style="info" %}
Bitte beachte, dass Du bei Payrexx [eingeloggt](https://login.payrexx.com/de) sein musst, bevor Du beginnst. Falls Du noch kein Konto hast, [registriere](https://signup.payrexx.com/de/email-validation/) Dich bitte bei Payrexx.
{% endhint %}

* Navigiere in der Händler-Administration Deines Payrexx-Kontos zu **API und Integrationen**.
* Klicke unterhalb von "E-Commerce Integration hinzufügen" auf "Alle anzeigen".
* Scrolle hinunter und klicke bei saldia auf die Schaltfläche "Hinzufügen":

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FptqS3MVqgSkeLGm1Y5qf%2Fimage.png?alt=media&#x26;token=abdfe8c5-4eb5-4875-bf00-9eebda47b367" alt=""><figcaption><p>Start der Einrichtung von saldia in Payrexx</p></figcaption></figure></div>

* Es öffnet sich folgendes Fenster:

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FBocKA7FCqNYyQuo9VFSm%2Fimage.png?alt=media&#x26;token=20ecf1c7-a10b-45d4-921c-16e2bb9c822e" alt=""><figcaption><p>Einstellungen zur Integration von saldia in Payrexx</p></figcaption></figure></div>

1. **Konfigurieren:** In den beiden Feldern werden der automatisch durch Payrexx generierte Wert für den API-Schlüssel und der Name Deiner Payrexx-Instanz angezeigt. Diese beiden Werte benötigst Du später bei der [Konfiguration von saldiaShop](#konfiguration-von-saldiashop).
2. **Shop-Adresse eingeben:** Erfasse in diesem Feld die URL Deines Shops. Falls sich Dein Shop nicht im Hauptverzeichnis (<https://mein-shop.com>) befindet, sondern in einem Unterverzeichnis, gibt bitte den kompletten Pfad zu Deinem Shop an. Beispiel: <https://mein-shop.com/shop>

{% hint style="warning" %}
Bitte beachte, dass Du die Shop-Adresse korrekt einträgst. Abweichungen (z. B. http\:// statt https\:// können zu Fehlern bei der Verarbeitung der Webhooks führen.
{% endhint %}

4. **Webhooks:** Definiere, ob ein fehlgeschlagener Webhook erneut ausgeführt werden soll oder nicht. Ist die Checkbox aktiviert, wird bis zu 10 Mal versucht, den Webhook erneut zu versenden. Die Abstände der Versuche betragen 5 Minuten, 15 Minuten, 1 Stunde, 2 Stunden, 4 Stunden und danach jeweils 24 Stunden.
5. **Abschliessen:** Klicke auf die grüne Schaltfläche "Aktivieren", um die Konfiguration abzuschliessen und die Einstellungen zu speichern.

### Konfiguration von saldiaShop

* Logge Dich in Dein Konto von saldiaShop ein.
* Navigiere im Hauptmenü zu **saldiaApps**.
* Um die App von Payrexx aktivieren zu können, muss zuerst die App von saldiaPay deaktiviert werden. Klicke hierfür unterhalb von saldiaPay auf "Bearbeiten":

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FFGyYFJyYHTCRteB9PbCK%2Fimage.png?alt=media&#x26;token=279fad00-63b8-4a63-a33f-e114b66c22e2" alt="" width="221"><figcaption><p>Bearbeiten der App saldiaPay</p></figcaption></figure></div>

* Klicke auf "App deaktivieren" und im nächsten Schritt auf "Bestätigen":

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FTNpLKLISAGieVNkHa3kN%2Fimage.png?alt=media&#x26;token=9822fdcd-cd74-4aca-ab48-46add98b2f85" alt="" width="563"><figcaption><p>Deaktivieren der App von saldiaPay</p></figcaption></figure></div>

* Scrolle in der Liste nach unten und klicke bei der App von Payrexx auf "Hinzufügen":

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FgctxLu7G6KRcup2CZVZI%2Fimage.png?alt=media&#x26;token=92de6f27-3a67-45ea-86a7-5bb3a9a82490" alt="" width="563"><figcaption><p>Hinzufügen der Payrexx-App in saldiaShop</p></figcaption></figure></div>

* Klicke im nächsten Fenster auf die grüne Schaltfläche "Kaufen":

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2F2GIOyFseqmXY1LXg0OgI%2Fimage.png?alt=media&#x26;token=bbd74b19-533a-4109-b1ad-b897dd56e092" alt="" width="375"><figcaption><p>Erstellen der Payrexx-App in saldiaShop</p></figcaption></figure></div>

* Füge den Instanznamen und den API-Schlüssel aus [Payrexx](#konfiguration-von-payrexx) in die entsprechenden Felder ein und klicke auf "Änderungen speichern":

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FEt6zmxH3k6FJgew2j9ci%2Fimage.png?alt=media&#x26;token=b6fc0a82-b29f-4352-a85b-0ec23be50f3c" alt="" width="563"><figcaption><p>Erfassen von Instanzname und API-Schlüssel in saldiaPay</p></figcaption></figure></div>

{% hint style="success" %}
Die Konfiguration ist damit abgeschlossen. Payrexx ist erfolgreich in saldiaShop integriert.
{% endhint %}