> For the complete documentation index, see [llms.txt](https://docs.spiroq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spiroq.com/de/anleitungen/navody/zahlungen/sumup-solo.md). # SumUp Solo Die Kartenzahlung am Automaten kann das Terminal **SumUp Solo** über das Internet abwickeln. Zwischen Automat und Terminal **gibt es kein MDB-Kabel**. Münzen laufen weiter über ihr eigenes Kabel. ## Was Sie benötigen * ein **SumUp-Business-Konto** (Merchant) — Anmeldung unter [me.sumup.com](https://me.sumup.com) * ein eingeschaltetes Terminal **SumUp Solo**, verbunden mit **Wi-Fi oder LTE**. Solo Lite ohne Internet reicht nicht. * Zugang zum **Admin Hub** (Rolle des Betreibers / Provider, Tarif **Pro** oder höher) * einen Automaten **online** im Admin Hub, mit aktueller Anwendung Spiroq Ein Solo gehört **genau zu einem Automaten**. Dasselbe Terminal lässt sich nicht gleichzeitig mit zwei Maschinen koppeln. ## Wie die Installation abläuft 1. In Ihrem SumUp-Konto erstellen Sie einen API-Schlüssel und Affiliate Keys. 2. Im HUB verbinden Sie das Konto unter **Einstellungen → Zahlungen**. 3. Am Terminal SumUp Solo erzeugen Sie einen Kopplungscode und geben ihn in den Automatendetails ein. 4. Am Automaten schalten Sie unter **Zahlungen** die Karte auf **Cloud API** um und prüfen den Einkauf. ## Schritt 1: Angaben aus dem SumUp-Konto Alle Werte nehmen Sie aus dem **eigenen** SumUp-Konto der Firma, die die Automaten betreibt. Es ist nicht das Konto von Spiroq. Das Terminal SumUp Solo muss bei demselben Konto registriert sein, aus dem Sie die Schlüssel erstellen. ### 1.1 Melden Sie sich an 1. Öffnen Sie [me.sumup.com](https://me.sumup.com). 2. Melden Sie sich mit dem Konto an, unter dem Sie das Solo haben. ### 1.2 Erstellen Sie einen API-Schlüssel 1. Öffnen Sie im Dashboard **Einstellungen** (Zahnrad). 2. Wechseln Sie in den Bereich **Für Entwickler** / **Developers**. 3. Öffnen Sie **API-Schlüssel** / **API keys**. 4. Tippen Sie auf **API-Schlüssel erstellen** / **Create API key**. 5. Wählen Sie einen verständlichen Schlüsselnamen, z. B. `SPIROQ HUB`. 6. Erlauben Sie die Rechte, die SumUp beim Schlüssel anbietet: * **Readers** (Terminals und Kopplung des Solo) * **Transactions** (Zahlungen) * **Refunds** (Erstattung, wenn ein Teil des Einkaufs nicht ausgegeben wird) 7. Bestätigen Sie die Erstellung. SumUp zeigt den geheimen Schlüssel in der Form `sup_sk_…`. Er wird **nur einmal** angezeigt. Kopieren Sie ihn sofort und halten Sie ihn für Schritt 2 bereit. Wenn Sie ihn verlieren, widerrufen Sie den Schlüssel bei SumUp und erstellen Sie einen neuen. Senden Sie den Schlüssel nicht per E-Mail und nicht in einen Chat. ### 1.3 Erstellen Sie Affiliate Keys Der API-Schlüssel allein reicht für die Zahlung nicht. Beim selben Konto benötigen Sie noch **Affiliate Application ID** und **Affiliate Key**. Ohne sie kann sich das Konto im HUB verbinden, die Kartenzahlung am Automaten geht aber nicht durch. 1. Öffnen Sie [developer.sumup.com](https://developer.sumup.com) und melden Sie sich mit demselben Konto an wie in Schritt 1.1. 2. Öffnen Sie **Affiliate Keys**. 3. Erstellen Sie einen neuen Schlüssel (**Create key**). 4. Wählen Sie die **Application ID** als Identifikator Ihrer Firma, zum Beispiel `com.yourcompany.vending`. Es ist nicht der Identifikator von Spiroq. 5. Kopieren Sie den **Affiliate Key**. Er beginnt mit `sup_afk_…`. Bei einem älteren Konto kann er die Form einer UUID haben. Die Application ID ist im Portal auch später sichtbar. Den Affiliate Key kopieren Sie wie den API-Schlüssel sofort. In den HUB werden beide Werte zusammen mit dem API-Schlüssel eingefügt. Bevor Sie weitergehen, halten Sie das Solo eingeschaltet und mit Wi-Fi oder LTE verbunden. Am Solo ist das **Einstellungen → Verbindungen** (Settings → Connections). ## Schritt 2: Verbindung im HUB 1. Öffnen Sie im Admin Hub **Einstellungen → Zahlungen**. 2. Wählen Sie SumUp. 3. Fügen Sie den **API-Schlüssel** (`sup_sk_…`), die **Affiliate Application ID** und den **Affiliate Key** (`sup_afk_…`) ein. 4. Tippen Sie auf **Konto verbinden**. Der HUB prüft den Schlüssel bei SumUp. Nach dem Erfolg ist der Status **Verbunden**, Sie sehen den **Händlercode** und die Währung des Kontos. Alle drei Felder verschwinden vom Bildschirm. Der HUB zeigt sie nicht erneut, nur die letzten vier Zeichen des API-Schlüssels und des Affiliate Key. Die Angaben können Sie später mit der Option **Kontozugangsdaten ersetzen** ändern — Sie fügen Schlüssel, Application ID und Affiliate Key erneut ein. **Trennen** löscht die gespeicherten Angaben. Automaten, die über SumUp gelaufen sind, kehren zur Kabelkarte zurück, und gekoppelte Terminals werden entkoppelt. Bei der nächsten Verbindung müssen die Schlüssel erneut eingegeben werden. ### Transaktionsobergrenze **Transaktionsobergrenze** ist die Obergrenze einer einzelnen Kartenzahlung. Darüber nimmt der HUB die Zahlung nicht an, auch wenn der Automat einen höheren Betrag sendet. Geben Sie den Betrag in **Max. Betrag pro Zahlung** ein und tippen Sie auf **Obergrenze speichern**. **Status prüfen** prüft, dass der Schlüssel bei SumUp weiterhin gilt. Wenn SumUp den Schlüssel ablehnt, ist der Status **API-Schlüssel abgelehnt — erneut verbinden** — verbinden Sie das Konto erneut mit einem neuen Schlüssel. ## Schritt 3: Solo mit dem Automaten koppeln Das Konto aus Schritt 2 gilt für die gesamte Firma. Jedes Terminal SumUp Solo wird dann einzeln gekoppelt, immer mit einem Automaten. 1. Prüfen Sie im HUB unter **Einstellungen → Zahlungen**, dass das Konto **Aktiv** ist. 2. Der Automat, den SumUp Solo bedienen soll, muss im HUB **online** sein. 3. Öffnen Sie am Terminal **Einstellungen → Verbindungen → API** (Settings → Connections → Pair with API). 4. Auf dem Display steht der Kopplungscode, 8 bis 9 Zeichen. Er gilt ungefähr 5 Minuten. Wenn er abläuft, erzeugen Sie einen neuen. 5. Öffnen Sie im HUB **Automatendetails → Automat bearbeiten → Leser koppeln** und fügen Sie den Code ein. Der Name des Lesers ist optional. Nach dem Erfolg erscheint in der Kopfzeile der Details **Karte: SumUp**. In den Details gibt es die Karte **SumUp-Terminal**: Status online oder offline und die Schaltfläche **Entkoppeln**. Die Kopplung im HUB allein **schaltet am Automaten den Kartenmodus nicht um**. Am Automaten müssen Sie Servicemenü → **Zahlungen** öffnen und oben **Cloud API** wählen (statt MDB). Ohne diese Umschaltung wartet der Automat weiter auf ein angeschlossenes MDB-Terminal. ## Schritt 4: Prüfung Im Servicemenü **Zahlungen**, im Bereich **SUMUP CLOUD (KARTE ÜBER DAS INTERNET)**, gibt es die Optionen **Status aktualisieren** und **Test 1 CZK (Storno)**. Der Test zeigt auf dem Terminal SumUp Solo kurz 1 CZK an und bricht die Zahlung sofort ab. Ware wird nicht ausgegeben. Einkauf des Kunden: 1. Legen Sie auf dem Kundenbildschirm Ware in den Warenkorb und wählen Sie **Kartenzahlung**. 2. Am Automaten erscheint **Karte an das Terminal halten**. Auf dem Terminal SumUp Solo steht derselbe Betrag. 3. Halten Sie die Karte an. Nach der Freigabe fährt die Ware aus. 4. Der Verkauf steht im HUB in den Automatendetails auf der Registerkarte **Verkäufe**. **Zahlung abbrechen** am Automaten beendet die Aufforderung, es wird nichts belastet. ## Problemlösung | Was Sie sehen | Was Sie tun | | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Zahlungen** sind gesperrt | Tarif **Pro** aktivieren | | **Konto verbinden** schlägt fehl | Einen neuen Schlüssel `sup_sk_…` aus demselben Konto wie SumUp Solo einsetzen, mit den Rechten Readers + Transactions + Refunds, ausgefüllte Affiliate Keys | | Beim Konto fehlen Affiliate Keys | **Kontozugangsdaten ersetzen** und Application ID sowie Affiliate Key einfügen | | Status **API-Schlüssel abgelehnt — erneut verbinden** | Der Schlüssel bei SumUp ist nicht gültig. Erstellen Sie einen neuen API-Schlüssel und verbinden Sie das Konto im HUB erneut | | Der Kopplungscode gilt nicht | Erzeugen Sie am Terminal SumUp Solo einen neuen. Das Terminal Solo muss auf demselben SumUp-Konto sein wie der API-Schlüssel | | **Mit Karte zahlen** fehlt am Automaten | Wahrscheinliche Ursachen: Terminal SumUp Solo offline, getrenntes Konto, nicht gekoppelter Leser, oder im Servicemenü → **Zahlungen** ist nicht **Cloud API** ausgewählt | | Ein Teil des Warenkorbs ist nicht ausgefahren | Spiroq versucht, die Differenz selbst zu erstatten. In den Verkaufsdetails ist der Status Teilweise erstattet / Erstattung fehlgeschlagen. Andernfalls erstatten Sie manuell im SumUp-Dashboard | | SumUp Solo ohne Internet | Verwenden Sie ein Solo mit Wi-Fi oder LTE, oder bleiben Sie bei der MDB-Karte |