Ab App-Version 1.15 können Sie sich mithilfe der Deeplink-API direkt aus Ihrem eigenen System heraus in die Anwendung ein- und ausloggen. Dank dieser direkten, API-basierten An- und Abmeldefunktion müssen Mitarbeiter nicht mehr zur eigenständigen GP-tom-App wechseln und ihre Zugangsdaten manuell eingeben – Sie können den gesamten Vorgang nun direkt aus Ihrer eigenen Anwendung heraus steuern. Dies verkürzt die Zeit für die Aktivierung des Terminals, reduziert Support-Anfragen im Zusammenhang mit der Anmeldung und vereinfacht vor allem Arbeitsabläufe, bei denen häufig Personal oder Geräte wechseln (etwa bei Schichtdiensten in der Gastronomie oder im Einzelhandel oder wenn sich Kuriere Terminals teilen).
Anmeldung bei der App
Anfrage
Deeplink-Pfad: gptom://login
Beispielanruf:
gptom://login?
username=merchant%40example.com&
password=silneheslo&
tid=123456&
redirectUrl=gp%3A%2F%2Flogin
Wenn der Status ERROR den Wert error=passwordChangeRequired zurückgibt, deutet dies auf die erste Anmeldung des Benutzers hin, und der nachfolgend beschriebene Ablauf muss befolgt werden.
Erstmalige Anmeldung bei der Anwendung mit Passwortänderung
Wenn der Benutzer noch kein Passwort für die Deeplink-Anmeldung festgelegt hat (Erst-Anmeldung), gibt der Anmeldeaufruf den Fehler `passwordChangeRequired` zurück. In diesem Fall ist es erforderlich, einen `change-password`-Deeplink in zwei Schritten zu senden.
Anfrage
Deeplink-Pfad: gptom://change-password
Schritt 1 – ohne Anforderung eines Bestätigungscodes
Ein Aufruf ohne den Parameter „Code“. Bei Erfolg (status=COMPLETED, kein Fehler) sendet das System einen Bestätigungscode an die E-Mail-Adresse des Benutzers.
gptom://change-password?
username=merchant%40example.com&
password=silneheslo&
newPassword=NoveSilneHeslo1&
tid=123456&
redirectURL=gp%3A%2F%2Fchange-password
Schritt 2 – Bestätigung per Code
Derselbe Aufruf, einschließlich des per E-Mail übermittelten Code-Parameters. Bei Erfolg wird das Passwort geändert, und Sie können sich wie gewohnt anmelden.
gptom://change-password?
username=merchant%40example.com&
password=silneheslo&
newPassword=NoveSilneHeslo1&
tid=123456&
code=AsfweWW41515&
redirectURL=gp%3A%2F%2Fchange-password
Abmelden von der App
Anfrage
Deeplink-Pfad: gptom://logout
gp://logout?redirectUrl=gp%3A%2F%2Flogout
Status-Codes
EN: Request completed successfully.
EN: Request failed — see the error parameter for details.
EN: User cancelled the request inside the GP tom app.
Für die Anmeldung/Abmeldung relevante Fehlercodes
DE: Ungültiger Benutzername oder Passwort.
EN: The provided TID is not assigned to this user.
EN: The provided TID is already occupied by another user.
EN: The same user is already logged in on this device with a different TID.
EN: First login - password must be set first.
EN: This occurs upon the first login following step 1, when an authorization code is sent via email.
EN: The provided confirmation code for the password change is invalid.
EN: It was not possible to log in user.
EN: Incorrect credentials sent.
EN: Terminal setup has failed. Please contact our support.
Überprüfung des Anmeldestatus
Um festzustellen, ob der Benutzer bereits in der GP tom-Anwendung angemeldet ist, können Sie die Methode Get status aufrufen. Mit dieser Methode lassen sich aktuelle Informationen zum Status der Anwendung und zum angemeldeten Händler abrufen. Detaillierte Informationen zur Verwendung und Implementierung der Methode finden Sie in der iOS-Dokumentation zur Methode „Get status“.