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=starkesPasswort&
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=starkesPasswort&
newPassword=NeuesStarkesPasswort1&
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=starkesPasswort&
newPassword=NeuesStarkesPasswort1&
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: Die Anfrage wurde erfolgreich abgeschlossen.
EN: Die Anfrage ist fehlgeschlagen – weitere Informationen finden Sie im Fehlerparameter.
EN: Der Benutzer hat die Anfrage in der GP tom-App storniert.
Für die Anmeldung/Abmeldung relevante Fehlercodes
DE: Ungültiger Benutzername oder Passwort.
EN: Die angegebene TID ist diesem Benutzer nicht zugeordnet.
EN: Die angegebene TID wird bereits von einem anderen Benutzer verwendet.
EN: Der gleiche Benutzer ist auf diesem Gerät bereits mit einer anderen TID angemeldet.
EN: Erste Anmeldung – Das Passwort muss zuerst festgelegt werden.
EN: Dies geschieht bei der ersten Anmeldung nach Schritt 1, wenn ein Autorisierungscode per E-Mail versendet wird.
EN: Der angegebene Bestätigungscode für die Passwortänderung ist ungültig.
EN: Der Benutzer konnte sich nicht anmelden.
EN: Es wurden falsche Anmeldedaten gesendet.
EN: Die Terminal-Einrichtung ist fehlgeschlagen. Bitte wenden Sie sich an unseren 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“.