> For the complete documentation index, see [llms.txt](https://stamply.gitbook.io/stamply-knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stamply.gitbook.io/stamply-knowledge-base/integrationen/square.md).

# ⚫ Square

Bei der Integration mit „Square Marketplace” handelt es sich um eine einseitige Verbindung, bei der alle Transaktionsdaten von Square zu StampReady fließen.

Diese Integration funktioniert nur mit den folgenden Stamplycard-Typen: '**Stamp, Cashback, Rabatt und Belohnung**'. Basierend auf den Kaufdaten, die von Square empfangen werden, wendet das System automatisch die erwartete Gewinnerlogik für diese Kartentypen an.\
\
Bitte beachten Sie, dass Belohnungen oder Vorteile nicht innerhalb von Square verarbeitet werden können — alle Abnahmen müssen über uns abgeschlossen werden[**Scanner App**](https://docs.boomerangme.cards/scanner-app).

Um die erforderlichen Anmeldeinformationen zu erhalten, verbinden Sie zunächst die Integration SQL in Ihrem Stamply-Konto und speichern Sie die Integration-ID unter „Integrations”. Anschließend können Sie die Integration löschen.

<figure><img src="/files/OBbBFoYTRAZnhBkEeehj" alt=""><figcaption></figcaption></figure>

Um die Square-App zu konfigurieren, melden Sie sich bei Ihrem Square-Konto an und gehen Sie zu<https://developer.squareup.com/console/en/apps>.

Drücken Sie das „+“

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2F4KXlwMXX5wyJnJjpbyG6%2FScreenshot%20at%20Nov%2014%2021-08-07.png?alt=media&#x26;token=08a25861-1fbb-4ac3-aa22-b853397f2e2a" alt=""><figcaption></figcaption></figure>

Geben Sie den Namen der Anwendung ein

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FQ7YjZmap9qiuj1iN30bZ%2FScreenshot%20at%20Nov%2014%2021-09-21.png?alt=media&#x26;token=7f0d441c-8efe-4bcf-82de-9e0b64c13627" alt=""><figcaption></figcaption></figure>

Nach Belieben anpassen oder die nächsten 2 Fenster überspringen.

<div><figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2Fw7hsOnqrMblhVCR8WObg%2FScreenshot%20at%20Nov%2015%2010-12-13.png?alt=media&#x26;token=d27aaa6e-c38e-4b6b-8e96-e5e8d94b3b56" alt=""><figcaption></figcaption></figure> <figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FsZIAzVMiFAOmvPqLiuJu%2FScreenshot%20at%20Nov%2014%2021-10-20.png?alt=media&#x26;token=0fffa73f-9d39-44d0-b589-96c954caaf30" alt=""><figcaption></figcaption></figure></div>

Unter Anmeldeinformationen können Sie zu einem Sandbox- und Produktionskonto wechseln.&#x20;

Gehen Sie zum Produktionskonto.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FUeSJfwAoVpirzKxfNZjg%2FScreenshot%20at%20Nov%2006%2016-26-22.png?alt=media&#x26;token=cda661b6-fe02-4da4-ab2f-37fcb47ba1b2" alt=""><figcaption></figcaption></figure>

Gehe zu Webhooks -> Abonnements -> Abonnement hinzufügen.

<figure><img src="/files/cCxS4ZW7YTYjf6PD0nQB" alt=""><figcaption></figcaption></figure>

Geben Sie den Namen des Webhooks ein, in der URL eingeben <https://square.apps.digitalwallet.cards/square/webhook>

Wählen Sie in den Veranstaltungen nur:\
1\. zahlungerstellt
\
2\. zahlung aktualisiert
\
3\. einbehalt erstellt
\
4\. einbehalt aktualisiert

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2Fyey0KlQ8RxQLwdEH02EL%2FScreenshot%20at%20Nov%2006%2015-00-35.png?alt=media&#x26;token=d88739b1-5913-4ae2-bb14-4d387916758b" alt=""><figcaption></figcaption></figure>

Klicken Sie auf Speichern.

Jetzt im Stamply-Konto, gehen Sie zu Integrations und verbinden Sie die Square-App.

<figure><img src="/files/cPpCSzMCnxZc4AOhWbAR" alt=""><figcaption></figcaption></figure>

Wählen Sie zunächst ein Kartenmuster aus (Stempel, Cashback, Rabatt oder Belohnung). Beachten Sie bitte, dass bei Stempel- und Punktemechanismen die Akkumulation über den Scanner erfolgen sollte. Eine automatische Akkumulation wird über den Markt nicht durchgeführt.

Geben Sie die Händler-ID (Ihre in Schritt eins gespeicherte Integration-ID) sowie den Square-App-Zugriffstoken ein.

<figure><img src="/files/hGyTZJOB1wfUjoUO8jFF" alt=""><figcaption></figcaption></figure>

Wählen Sie eine Zinsregel aus:

* für den gesamten Scheck,
* für einen Scheck über einen bestimmten Betrag oder
* für bestimmte Artikel.

<div><figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FlT5Wn2IwTmwICJ4SjI4n%2FScreenshot%20at%20May%2023%2017-16-18.png?alt=media&#x26;token=e6fef5b8-9cdf-4caf-ae5e-bfd4a461f50a" alt=""><figcaption></figcaption></figure> <figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FPSOVYDg6SPnkvVYEn589%2FScreenshot%20at%20May%2023%2017-16-31.png?alt=media&#x26;token=c5d1b8de-ce3a-4b1b-954c-271e81f19548" alt=""><figcaption></figcaption></figure> <figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2F9GVDZFDEiJQhZmaWJVSm%2FScreenshot%20at%20May%2023%2017-16-43.png?alt=media&#x26;token=594680cd-906a-4e72-8497-5ba532ef50be" alt=""><figcaption></figcaption></figure></div>

Wählen Sie Lieferkanäle für Kartendienstinstallationen aus.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FKX7l5crgV4mCx6TrNoEb%2FScreenshot%20at%20Nov%2014%2021-17-56.png?alt=media&#x26;token=f5ccedb8-2911-4aa4-a33c-2355a8e3fb32" alt=""><figcaption></figcaption></figure>

Erstellen Sie Rechnungen und nehmen Sie Zahlungen über ein virtuelles Terminal entgegen. Nach der Zahlung werden die Bestelldetails an StampReady übermittelt. Bei einer Stornierung der Bestellung werden die Punkte von der Karte abgezogen.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FLGCtMdv0zcEztLuZg5MZ%2FScreenshot%20at%20Nov%2014%2021-19-33.png?alt=media&#x26;token=c11b8dc1-e4f5-4643-8ae2-3fbb29263d68" alt=""><figcaption></figcaption></figure>

Wenn ein Kunde mit dieser Telefonnummer und E-Mail-Adresse bereits im Besitz einer Treuekarte ist, werden ihm Punkte gutgeschrieben. Ist der Kunde noch nicht im System vorhanden, wird er angelegt, die Karte ausgegeben und der Link zur Installation der Karte an die ausgewählten Lieferkanäle gesendet (benötigt wird ein verbundener E-Mail-Dienst in Ihrem Konto). Achtung! Die Währung im Stamply-Konto und in der App muss dieselbe sein.<br>