Der normale Ablauf
- Klicken Sie im Desktop-Browser auf
Connect wallet(Wallet verbinden) und wählen Sie die Option für Mobile Pairing. - Die App zeigt einen QR-Code mit einem kurzen Gültigkeitsfenster.
- Öffnen Sie die Wallet-App auf dem Telefon und nutzen Sie deren eingebauten Scanner – nicht die System-Kamera, es sei denn, Ihre Wallet unterstützt Deep Links aus der Kamera-App.
- Bestätigen Sie die Kopplungsanfrage, die in der Wallet erscheint.
- Der Desktop-Tab wechselt in den verbundenen Zustand und fragt nach einer Session-Signatur.
Häufige Fehlerbilder
Die Kamera öffnet sich nicht. Ihre Wallet-App hat keine Kameraberechtigung. Erteilen Sie sie in den Einstellungen des Betriebssystems und versuchen Sie es erneut. Unter iOS finden Sie die Berechtigung in den Einstellungen unter Datenschutz und dort unter Kamera; unter Android in der App-Info unter Berechtigungen. Der QR-Code lief ab, bevor Sie ihn scannen konnten. Die Codes sind aus Sicherheitsgründen kurzlebig. Klicken Sie auf der Desktop-Seite aufrefresh oder show new code und scannen Sie den frischen Code zügig.
Die Wallet meldet „pairing failed“ oder es passiert gar nichts. Das Kopplungsprotokoll benötigt einen Relay-Server, der von beiden Geräten erreichbar ist. Ist Ihr Telefon in einem Firmen-WLAN, einem Hotelnetz oder hinter einem VPN, das ausgehenden WebSocket-Verkehr blockiert, erreicht es den Relay nie. Wechseln Sie am Telefon auf Mobilfunk oder in ein anderes Netz und versuchen Sie es erneut.
Die Kopplung gelingt, aber jede Aktion schlägt fehl. Die Session ist zwar zustande gekommen, aber auf dem Signaturpfad stimmt etwas nicht. Übliche Ursachen: Die Wallet ist mit dem falschen Konto gekoppelt, die Wallet unterstützt das Verfahren für Session-Signaturen nicht (aktualisieren Sie sie), oder das Telefon ist eingeschlafen und hat den Relay im Hintergrund getrennt. Trennen Sie die Kopplung auf der Wallet-Seite, öffnen Sie die Wallet neu und durchlaufen Sie den Ablauf noch einmal.
Was Sie uns schicken, wenn nichts davon hilft
Schreiben Sie ancontact@intention.xyz und geben Sie an:
- Name und Version Ihrer Mobile-Wallet.
- Betriebssystem und Version des Telefons.
- Desktop-Browser und Version.
- Ein Foto oder einen Screenshot des Fehlers, der auf dem Telefon angezeigt wird.
- Die ungefähre UTC-Zeit des Kopplungsversuchs.