Od verze aplikace 1.15 je možné provést přihlášení a odhlášení z aplikace přímo z vašeho systému pomocí deeplink API. Díky přímému přihlášení/odhlášení přes API se obsluha nemusí přepínat do samostatné GP tom aplikace a ručně zadávat přihlašovací údaje — celý proces nyní můžete řídit ze své vlastní aplikace. To zkracuje dobu potřebnou k aktivaci terminálu, snižuje počet dotazů na podporu ohledně přihlašování a hlavně zjednodušuje situace s častým střídáním obsluhy nebo zařízení (směny v gastru/retailu, kurýři sdílející terminály mezi směnami).
Přihlášení do aplikace
Request
Cesta deeplinku: gptom://login
Příklad volání
gptom://login?
username=merchant%40example.com&
password=silneheslo&
tid=123456&
redirectUrl=gp%3A%2F%2Flogin
Pokud se ve stavu ERROR vrátí error=passwordChangeRequired, jedná se o první přihlášení uživatele a je potřeba projít flow popsané níže.
Prvotní přihlášení do aplikace se změnou hesla
Pokud uživatel ještě nemá nastavené heslo pro deeplink přihlášení (první přihlášení), vrátí login volání chybu
passwordChangeRequired. V takovém případě je nutné zaslat deeplink change-password, a to ve dvou
krocích.
Request
Cesta deeplinku: gptom://change-password
Krok 1 – bez vyžádání ověřovacího kódu
Volání bez parametru Code. V případě úspěchu (status=COMPLETED, bez erroru) systém odešle ověřovací kód na e-mail uživatele.
gptom://change-password?
username=merchant%40example.com&
password=silneheslo&
newPassword=NoveSilneHeslo1&
tid=123456&
redirectURL=gp%3A%2F%2Fchange-password
Krok 2 – potvrzení kódem
Stejné volání doplněné o parametr code zaslaný na e-mail. V případě úspěchu je heslo změněno a lze pokračovat běžným loginem.
gptom://change-password?
username=merchant%40example.com&
password=silneheslo&
newPassword=NoveSilneHeslo1&
tid=123456&
code=AsfweWW41515&
redirectURL=gp%3A%2F%2Fchange-password
Odhlášení z aplikace (Logout)
Request
Cesta deeplinku: gptom://logout
gp://logout?redirectUrl=gp%3A%2F%2Flogout
Stavové kódy
EN: Request completed successfully.
EN: Request failed — see the error parameter for details.
EN: User cancelled the request inside the GP tom app.
Chybové kódy relevantní pro login/logout
EN: Invalid username or password.
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.
Ověření stavu přihlášení
Pro zjištění stavu aplikace zda je již uživatel v aplikaci GP tom přihlášen, je možné zavolat metodu Get status. Metoda umožňuje získat aktuální informace o stavu aplikace a přihlášeném obchodníkovi. Podrobné informace o použití metody a její implementaci najdete v iOS dokumentaci k metodě Get status.