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=erős jelszó&
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=erős jelszó&
newPassword=ÚjErősJelszó1&
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=erős jelszó&
newPassword=ÚjErősJelszó1&
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: A kérés sikeresen végrehajtásra került.
EN: A kérés sikertelen volt — a részletekért lásd a hiba paramétert.
EN: A felhasználó a GP tom alkalmazáson belül törölte a kérést.
Bejelentkezéssel/kijelentkezéssel kapcsolatos hibakódok
HU: Érvénytelen felhasználónév vagy jelszó.
EN: A megadott TID-szám nem tartozik ehhez a felhasználóhoz.
EN: A megadott TID-t már egy másik felhasználó foglalja.
EN: Ugyanaz a felhasználó már be van jelentkezve ezen az eszközön egy másik TID-vel.
EN: Első bejelentkezés – először be kell állítani a jelszót.
EN: Ez az 1. lépés után az első bejelentkezéskor történik, amikor e-mailben elküldik az engedélyezési kódot.
EN: A jelszóváltoztatáshoz megadott megerősítő kód érvénytelen.
EN: Nem sikerült bejelentkezni a felhasználónak.
EN: Helytelen hitelesítő adatok kerültek elküldésre.
EN: A terminál beállítása sikertelen volt. Kérjük, vegye fel a kapcsolatot ügyfélszolgálatunkkal.
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.