Az alkalmazás 1.15-ös verziójától kezdve a deeplink API segítségével közvetlenül a saját rendszeréből is bejelentkezhet az alkalmazásba, illetve kijelentkezhet abból. Ez a közvetlen, API-alapú be- és kijelentkezési lehetőség feleslegessé teszi, hogy a munkatársak átváltsanak az önálló GP tom alkalmazásra, és manuálisan adják meg a belépési adatokat – immár a teljes folyamat a saját alkalmazáson belül kezelhető. Ez csökkenti a terminál aktiválásához szükséges időt, mérsékli a bejelentkezéssel kapcsolatos támogatási megkeresések számát, és – ami a legfontosabb – egyszerűsíti a gyakori személyzet- vagy eszközcserével járó munkafolyamatokat (például a vendéglátásban vagy a kiskereskedelemben zajló műszakváltásokat, illetve azt az esetet, amikor a futárok műszakváltáskor közösen használják a terminálokat).
Bejelentkezés az alkalmazásba
Kérés
Mélylink útvonala: gptom://login
Hívási példa:
gptom://login?
username=merchant%40example.com&
password=silneheslo&
tid=123456&
redirectUrl=gp%3A%2F%2Flogin
Amennyiben az ERROR állapot az error=passwordChangeRequired értéket adja vissza, az a felhasználó első bejelentkezését jelzi, és az alábbiakban ismertetett folyamatot kell követni.
Első bejelentkezés az alkalmazásba jelszóváltoztatással
Ha a felhasználó még nem állított be jelszót a mélylinkes (deeplink) bejelentkezéshez (első bejelentkezés), a bejelentkezési hívás `passwordChangeRequired` hibát ad vissza. Ebben az esetben két lépésben kell elküldeni a `change-password` mélylinket.
Kérés
Mélylink útvonala: gptom://change-password
1. lépés – ellenőrző kód igénylése nélkül
Egy hívás a Code paraméter nélkül. Sikeres végrehajtás esetén (status=COMPLETED, hiba nélkül) a rendszer ellenőrző kódot küld a felhasználó e-mail-címére.
gptom://change-password?
username=merchant%40example.com&
password=silneheslo&
newPassword=NoveSilneHeslo1&
tid=123456&
redirectURL=gp%3A%2F%2Fchange-password
2. lépés – Megerősítés kód segítségével
Ugyanaz a hívás, beleértve az e-mailben küldött kód paramétert is. Sikeres művelet esetén a jelszó megváltozik, és folytathatja a folyamatot a szokásos bejelentkezéssel.
gptom://change-password?
username=merchant%40example.com&
password=silneheslo&
newPassword=NoveSilneHeslo1&
tid=123456&
code=AsfweWW41515&
redirectURL=gp%3A%2F%2Fchange-password
Kijelentkezés az alkalmazásból
Kérés
Mélylink útvonala: gptom://logout
gp://logout?redirectUrl=gp%3A%2F%2Flogout
Állapot kódok
EN: Request completed successfully.
EN: Request failed — see the error parameter for details.
EN: User cancelled the request inside the GP tom app.
Bejelentkezéssel/kijelentkezéssel kapcsolatos hibakódok
HU: Érvénytelen felhasználónév vagy jelszó.
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.
Bejelentkezési állapot ellenőrzése
Annak megállapításához, hogy a felhasználó bejelentkezett-e már a GP tom alkalmazásba, meghívhatja a Get status metódust. Ezzel a metódussal lekérheti az alkalmazás állapotára és a bejelentkezett kereskedőre vonatkozó aktuális információkat. A metódus használatával és implementálásával kapcsolatos részletes információk a Get status metódus iOS-dokumentációjában találhatók.