Od verzie aplikácie 1.15 je možné vykonať prihlásenie a odhlásenie z aplikácie priamo z vášho systému pomocou deeplink API. Vďaka priamemu prihláseniu/odhláseniu cez API sa obsluha nemusí prepínať do samostatnej GP tom aplikácie a ručne zadávať prihlasovacie údaje – celý proces teraz môžete riadiť zo svojej vlastnej aplikácie. To skracuje dobu potrebnú na aktiváciu terminálu, znižuje počet otázok na podporu ohľadom prihlasovania a hlavne zjednodušuje situácie s častým striedaním obsluhy alebo zariadenia (smeny v gastri/retaile, kuriéri zdieľajúce terminály medzi smenami).
Prihlásenie do aplikácie
Žiadosť
Cesta deeplinku: gptom://login
Príklad volania:
gptom://login?
username=merchant%40example.com&
password=silneheslo&
tid=123456&
redirectUrl=gp%3A%2F%2Flogin
Pokiaľ sa v stave ERROR vráti error=passwordChangeRequired, jedná sa o prvé prihlásenie užívateľa a je potrebné prejsť flow popísané nižšie.
Prvé prihlásenie do aplikácie so zmenou hesla
Ak používateľ ešte nemá nastavené heslo pre deeplink prihlásenie (prvé prihlásenie), vráti login volania chybu
passwordChangeRequired. V takom prípade je nutné zaslať deeplink change-password, a to v dvoch
krokoch.
Žiadosť
Cesta deeplinku: gptom://change-password
Krok 1 – bez vyžiadania overovacieho kódu
Volanie bez parametra Code. V prípade úspechu (status=COMPLETED, bez erroru) systém odošle overovací kód na e-mail užívateľa.
gptom://change-password?
username=merchant%40example.com&
password=silneheslo&
newPassword=NoveSilneHeslo1&
tid=123456&
redirectURL=gp%3A%2F%2Fchange-password
Krok 2 – potvrdenie kódom
Rovnaké volanie doplnené o parameter code zaslaný na e-mail. V prípade úspechu je heslo zmenené a je možné pokračovať bežným loginom.
gptom://change-password?
username=merchant%40example.com&
password=silneheslo&
newPassword=NoveSilneHeslo1&
tid=123456&
code=AsfweWW41515&
redirectURL=gp%3A%2F%2Fchange-password
Odhlásenie z aplikácie
Žiadosť
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é pre login/logout
EN: Neplatné používateľské meno alebo heslo.
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.
Overenie stavu prihlásenia
Pre zistenie stavu aplikácie či je už užívateľ v aplikácii GP tom prihlásený, je možné zavolať metódu Get status. Metóda umožňuje získať aktuálne informácie o stave aplikácie a prihlásenom obchodníkovi. Podrobné informácie o použití metódy a jej implementácii nájdete v iOS dokumentáciu k metóde Get status.