> ## Documentation Index
> Fetch the complete documentation index at: https://docs.echoauth.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# SellAuth-Zahlungsautomatisierung

> Akzeptiere mit deinem SellAuth-Shop in etwa 5 Minuten mehr Krypto-Coins mit NowPayments, Heleket oder Cryptomus.

Möchtest du in deinem SellAuth-Shop mehr Krypto-Zahlungen annehmen? Du kannst das in etwa **5 Minuten** selbst einrichten. Du brauchst keinen Server und schreibst keinen Code. Du füllst ein kurzes Formular aus, und ich betreibe deinen Checkout und halte ihn online.

* Eine **Krypto-Checkout-Seite** für deinen SellAuth-Shop
* Deine Wahl zwischen **Heleket, Cryptomus oder NowPayments**
* **Immer ein Processor gleichzeitig**. Wechsle jederzeit zu einem anderen.
* Ein einfaches Dashboard mit deinem Status und **Live-Logs**

![Lizenzseite mit einem laufenden Processor, den Lizenzdetails sowie der Pay-URL und der Webhook-URL](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-09-live.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=777b90af5fca72a76d66882aeffa185c)

Dein Checkout ist live: Laufstatus und deine zwei URLs

## Es dauert 3 Schritte

**1. Lizenz holen**

Kaufe eine Lizenz. Du erhältst einen Schlüssel, der so aussieht: `ECHO-XXXX-XXXX-XXXX-XXXX`.

**2. Account erstellen und einen Processor verbinden**

Registriere dich mit deinem Schlüssel, wähle einen Processor und fülle ein Formular aus.

**3. 2 URLs einfügen. Fertig.**

Kopiere deine Pay-URL in SellAuth und deine Webhook-URL in deinen Processor. Dein Shop akzeptiert jetzt Krypto.

> [!TIP]
>
> Springe zu: [Account erstellen](#1-create-your-account), [Processor verbinden](#2-connect-a-processor), [Deine zwei URLs](#3-your-two-urls-and-test-payment), [Processor wechseln](#4-switch-processor), [Weitere Lizenz hinzufügen](#5-add-another-license), [Verlängerungen](#6-renewals-and-expiry), [FAQ](#faq).

## Was du brauchst

> [!NOTE]
>
> **Halte Folgendes bereit:**
>
> * Deinen **Lizenzschlüssel** aus deinem Kauf
> * Deine **SellAuth-Shop-ID** und einen **SellAuth-API-Key**
> * Einen Account bei **Heleket, Cryptomus oder NowPayments** mit den zugehörigen API-Zugangsdaten

> [!NOTE]
>
> Die Screenshots verwenden erfundene Beispieldaten (Shop-ID `12345`, Keys wie `test-api-key-xxxx`). Nutze deine eigenen Werte und gib sie niemals weiter.

## 1. Account erstellen

**1. Registrierungsseite öffnen**

Öffne die Registrierungsseite deines Dashboards. Schon registriert? Klicke stattdessen auf **Sign in**.

**2. Formular ausfüllen**

Wähle einen Benutzernamen, gib deine E-Mail an und wähle ein Passwort mit mindestens 10 Zeichen. Füge unten deinen Lizenzschlüssel ein und klicke auf **Create account**.

![Formular Create your account mit Benutzername, E-Mail, Passwort und einem Platzhalter-Lizenzschlüssel](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-02-register.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=de5d4ca59d962cf12845af6d8fb11f03)

Registriere dich mit deinem Lizenzschlüssel (der hier gezeigte Schlüssel ist ein Platzhalter)

**3. Du bist drin**

Du bist sofort angemeldet. Deine Lizenz ist aktiv und deine Laufzeit beginnt jetzt.

> [!WARNING]
>
> Jeder Schlüssel funktioniert nur **einmal**. Wenn du "This license key is invalid or has already been used" siehst, prüfe den Schlüssel auf Tippfehler. Wenn es weiterhin fehlschlägt, frag den Support. Halte deinen Schlüssel privat.

## 2. Processor verbinden

Ein Processor ist der Dienst, der die Krypto-Zahlung abwickelt. Wähle **einen**. Du kannst später wechseln.

**1. Lizenz öffnen**

Klicke oben auf **Licenses**, dann auf deine Lizenz und danach auf **Set up processor**.

**2. Processor wählen**

![Seite Choose a processor mit Heleket, Cryptomus und NowPayments](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-12-swap-pick.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=37c8d5376e810510e3154b83a831249d)

Wähle NowPayments, Heleket oder Cryptomus

**3. Formular ausfüllen**

Jedes Formular verlangt deine **SellAuth-Shop-ID**, deinen **SellAuth-API-Key** (Required Scopes: Invoice Read, Update, Process) und die Zugangsdaten deines Processors. Siehe den Tab unten.

**4. Auf den grünen Button klicken**

Die Einrichtung dauert bis zu einer Minute. Lass die Seite geöffnet, bis sie fertig ist. Dann siehst du deinen Status und deine zwei URLs.

> [tab] NowPayments
>
> Du brauchst deinen **NowPayments API key** und dein **NowPayments IPN secret**.
>
> ![NowPayments-Einrichtungsformular mit Shop-ID, SellAuth-API-Key, NowPayments-API-Key und IPN-Secret](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-07-form-nowpayments.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=39fed9e70b8671401993c77d8b68de88)
>
> NowPayments-Einrichtungsformular

> [tab] Heleket
>
> Du brauchst deinen **Heleket API key** und deine **Heleket merchant ID**.
>
> ![Heleket-Einrichtungsformular mit Shop-ID, SellAuth-API-Key, Heleket-API-Key und Merchant-ID](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-05-form-heleket.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=bc33047c3633b689a025a94a80352bad)
>
> Heleket-Einrichtungsformular

> [tab] Cryptomus
>
> Du brauchst deinen **Cryptomus API key** und deine **Cryptomus merchant ID**.
>
> ![Cryptomus-Einrichtungsformular mit Shop-ID, SellAuth-API-Key, Cryptomus-API-Key und Merchant-ID](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-06-form-cryptomus.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=be948733d2644f3232a5e31bb93118e2)
>
> Cryptomus-Einrichtungsformular

> [!NOTE]
>
> Deine API-Zugangsdaten findest du im eigenen Dashboard deines Processors. Die Menünamen können sich von Zeit zu Zeit unterscheiden. Die SellAuth-Shop-ID ist nach der ersten Einrichtung **an deine Lizenz gebunden**. Wähle also den Shop, in dem du wirklich verkaufen willst.

> [!WARNING]
>
> **Häufige Fehler:** ein Tippfehler im SellAuth-API-Key oder in der Shop-ID, Verwechslung von API-Key und Merchant-ID (oder IPN-Secret) sowie Leerzeichen am Anfang oder Ende eines kopierten Keys. Wenn die Einrichtung fehlschlägt, siehst du eine rote Meldung, und das Formular behält deine Eingaben. Gib deine geheimen Keys erneut ein.
>
> ![Einrichtungsformular mit einer roten Fehlermeldung zum SellAuth-Shop-Key](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-08-setup-error.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=4651d603206104f9347e9b7a7cad394d)
>
> Beispielfehler: Der SellAuth-Key war falsch

## 3. Deine zwei URLs und Testzahlung

Das ist der letzte Schritt. Deine Lizenzseite zeigt **zwei URLs**. Jede gehört an eine andere Stelle.

![Karte Your URLs mit einer Pay-URL und einer Webhook-URL, jeweils mit einem Copy-Button](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-10-urls.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=d99a12e3fa909c00b4e3b5d9d9ece4b3)

Nutze die Copy-Buttons

| URL | Was sie tut | Wohin du sie einfügst |
| - | - | - |
| **Pay URL** | Leitet deinen Käufer zum Krypto-Checkout. | In SellAuth, als Redirect-URL der Zahlungsmethode |
| **Webhook URL** | Meldet dem Processor, wenn eine Zahlung abgeschlossen ist, damit die Bestellung als bezahlt markiert wird. | Im Dashboard deines Processors, als Callback- oder IPN-URL |

**1. Pay-URL in SellAuth einfügen**

Klicke neben **Pay URL** auf **Copy**. Öffne in SellAuth deine Zahlungsmethoden und setze die Redirect-URL darauf. Dein Dashboard sagt: *SellAuth, Payment methods, redirect URL*.

**2. Webhook-URL in deinen Processor einfügen**

Klicke neben **Webhook URL** auf **Copy**. Setze im Dashboard deines Processors die Callback- oder IPN-URL darauf. Dein Dashboard sagt zum Beispiel: *NowPayments dashboard, callback / IPN URL*.

**3. Status prüfen**

Die Processor-Karte auf deiner Lizenzseite zeigt ein grünes Badge **running**.

![Karte des aktiven Processors mit grünem Badge running und den Buttons Swap processor, Start, Stop und Restart](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-11-status.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=2e12cc1d83c2ff0ab711fe0c9c175f1f)

Ein laufender Processor

**4. Kleine Testbestellung aufgeben**

Kaufe eines deiner eigenen Produkte mit Krypto, mit einem kleinen Betrag. Scrolle auf deiner Lizenzseite zu **Logs**. Neue Zeilen erscheinen live, wenn eine Zahlungsanfrage eingeht. Nach der Bestätigung der Zahlung wird die Bestellung als bezahlt markiert und ausgeliefert.

> [!NOTE]
>
> Die Menünamen in SellAuth und im Dashboard deines Processors können etwas anders aussehen als hier beschrieben. Suche nach der Redirect-URL und der Callback- oder IPN-URL.

> [!WARNING]
>
> Lass `{unique_id}` in der Pay-URL **exakt so stehen, wie es geschrieben ist**. SellAuth füllt es für jede Bestellung aus.

Wenn etwas festzuhängen scheint, versuche zuerst **Restart** auf deiner Lizenzseite.

## 4. Processor wechseln

Du kannst pro Lizenz **einen Processor gleichzeitig** nutzen und jederzeit wechseln, zum Beispiel von NowPayments zu Heleket.

* **Bleibt gleich:** deine Lizenz, dein Ablaufdatum, deine SellAuth-Shop-ID und dein Key.
* **Ändert sich:** du gibst die Zugangsdaten des neuen Processors ein und erhältst **neue URLs**, die du erneut einfügen musst.

**1. Auf Swap processor klicken**

Öffne deine Lizenz, klicke auf **Swap processor** und wähle den neuen aus.

**2. Neues Formular ausfüllen**

Das Formular warnt dich, dass dein aktueller Checkout stoppt, sobald der neue live ist. Gib die neuen Zugangsdaten ein und setze zur Bestätigung den Haken.

![Heleket-Einrichtungsformular mit Swap-Warnung und Bestätigungs-Checkbox](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/cust-08-swap-heleket-form.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=0b1ba849c6addc55ea760a6675ffc7b2)

Wechsel von NowPayments zu Heleket

**3. Neue URLs einfügen**

Du siehst *Swap complete*. Aktualisiere die Redirect-URL in SellAuth und die Callback- oder IPN-URL im neuen Processor.

> [!WARNING]
>
> Nach einem Wechsel funktionieren die **alten URLs sofort nicht mehr**. Aktualisiere SellAuth schnell, damit Käufer nicht auf einem toten Link landen.

> [!TIP]
>
> Das ist sicher. Der neue Checkout startet zuerst und muss funktionieren, bevor sich etwas ändert. Wenn der Wechsel fehlschlägt, siehst du eine Meldung, dass dein alter Checkout **weiterhin aktiv ist**. Nichts geht verloren. Behebe das Problem und versuche es erneut.

## 5. Weitere Lizenz hinzufügen

Jede Lizenz gibt dir **einen Processor-Slot**. Füge eine weitere Lizenz für einen **zweiten SellAuth-Shop** oder einen **zweiten Processor** gleichzeitig hinzu.

**1. Auf Add license klicken**

Nutze **Add license** im oberen Menü. Füge den neuen Schlüssel ein und wähle **Add as new license**.

![Formular Add license mit einem Platzhalter-Schlüssel und den Optionen, als neue Lizenz hinzuzufügen oder eine bestehende zu verlängern](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-13-add-license.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=14b2d3b92a2864aae399a966fdd550e0)

Lizenz hinzufügen (Platzhalter-Schlüssel)

**2. Einrichten**

Dein Dashboard listet jede Lizenz mit eigenem Status und Ablaufdatum. Öffne die neue und verbinde einen Processor. Jede Lizenz hat ihren eigenen Shop und ihre eigenen URLs.

![Dashboard mit zwei Krypto-Lizenzen samt Status und Ablaufdatum](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-14-dashboard.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=af3a32d6459ba6339956c335debd28e1)

Dashboard mit mehreren Lizenzen

Aktuell gelten Lizenzen für **Krypto**-Zahlungen. Andere Kategorien wie Skins und Kartenzahlungen werden als **coming soon** angezeigt und sind noch nicht nutzbar.

## 6. Verlängerungen und Ablauf

Lizenzen gibt es für **1, 3, 6 oder 12 Monate**. Die Laufzeit beginnt, wenn **du dich registrierst oder den Schlüssel einlöst**, nicht beim Kauf. Du erhältst bei jeder Einlösung **2 Bonustage** obendrauf, für Einrichtung und Tests. Dein Ablaufdatum steht oben auf deiner Lizenzseite und in deinem Dashboard.

Wenn eine Lizenz abläuft:

* Dein Checkout **pausiert**. Käufer können nicht mehr mit Krypto bezahlen, bis du verlängerst.
* **Nichts wird gelöscht.** Deine Einstellungen und Logs bleiben erhalten.

![Lizenzseite mit einem Badge expired und einem Hinweis, einen Verlängerungsschlüssel einzulösen](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/cust-16-expired.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=97ca7e9f755a852e93465194003b0691)

Eine abgelaufene Lizenz mit Verlängerungsaufforderung

**1. Verlängerungsschlüssel holen**

Kaufe einen neuen Lizenzschlüssel.

**2. Einlösen**

Klicke auf deiner Lizenzseite auf **Redeem a renewal key** oder **Extend with a new key** und füge den Schlüssel ein.

**3. Fertig**

Deine Lizenz ist wieder aktiv und dein Checkout startet wieder. Deine URLs bleiben gleich.

> [!TIP]
>
> Du kannst **vor** dem Ablauf verlängern. Die neue Zeit wird auf dein aktuelles Enddatum aufgeschlagen, du verlierst also nichts.

> [!WARNING]
>
> Behandle einen Lizenzschlüssel wie ein Passwort. Poste ihn nicht öffentlich. Dein Dashboard zeigt nur die letzten 4 Zeichen. Dein Passwort kannst du unter **Settings** ändern.

## FAQ

> [accordion] Mein Lizenzschlüssel ist ungültig oder bereits verwendet
>
> Prüfe auf Tippfehler und zusätzliche Leerzeichen. Jeder Schlüssel funktioniert **einmal**. Wenn du dich schon damit registriert hast, melde dich stattdessen an. Wenn du sicher bist, dass er neu ist, frag Echo.

> [accordion] Die Einrichtung zeigt einen roten Fehler
>
> Meist ist es ein falscher SellAuth-API-Key, eine falsche Shop-ID oder falsche Zugangsdaten des Processors. Prüfe jedes Feld, entferne Leerzeichen und versuche es erneut. Das Formular zeigt dir die letzten Logzeilen des fehlgeschlagenen Versuchs als Hilfe.

> [accordion] Die Bestellung bleibt unbezahlt, obwohl der Käufer bezahlt hat
>
> Prüfe die **Webhook-URL** im Dashboard deines Processors. Sie muss genau die auf deiner Lizenzseite sein. Sieh dir dann die **Logs** auf deiner Lizenzseite auf Fehler an.

> [accordion] Käufer landen beim Checkout auf einer Fehlerseite
>
> Prüfe die **Redirect-URL** in SellAuth. Sie muss deine Pay-URL sein, mit unverändertem `{unique_id}`. Prüfe außerdem, dass deine Lizenz aktiv ist und das Badge **running** zeigt.

> [accordion] Ich habe den Processor gewechselt und der Checkout funktioniert nicht mehr
>
> Füge nach einem Wechsel die **neuen URLs** ein. Die alten funktionieren nicht mehr.

> [accordion] Mein Wechsel ist fehlgeschlagen
>
> Dein altes Setup bleibt **erhalten und weiterhin aktiv**. Lies die rote Meldung, korrigiere die Zugangsdaten und versuche es erneut.

> [accordion] Ich kann mich nicht anmelden
>
> Nach mehreren falschen Passwörtern wirst du eine Zeit lang gesperrt. **Warte etwa 15 Minuten** und versuche es erneut. Prüfe deinen Benutzernamen oder deine E-Mail.

> [accordion] Ich sehe die Meldung, es später erneut zu versuchen
>
> Es gibt ein Limit, wie oft du pro Stunde einrichten, wechseln oder Zugangsdaten ändern kannst. Warte kurz und versuche es erneut.

> [accordion] Ich möchte meinen SellAuth-Shop ändern
>
> Der Shop ist nach der ersten Einrichtung an die Lizenz gebunden. Bitte den Support um eine Änderung oder nutze eine andere Lizenz für den anderen Shop.

> [accordion] Ich habe mein Passwort vergessen
>
> Es wird keine E-Mail gesendet. Bitte den Support um ein Zurücksetzen des Passworts. Du kannst dein Passwort später unter **Settings** ändern.

> [accordion] Meine Lizenz ist abgelaufen
>
> Dein Checkout ist pausiert und nichts geht verloren. Löse einen Verlängerungsschlüssel ein. Siehe [Verlängerungen und Ablauf](#6-renewals-and-expiry).

Immer noch Probleme? Öffne ein Ticket auf meinem [Support-Server](https://discord.echoauth.dev).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.