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&
heslo=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&
heslo=silneheslo&
newPassword=NovéSilnéHeslo1&
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&
heslo=silneheslo&
newPassword=NovéSilnéHeslo1&
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: Žiadosť bola úspešne spracovaná.
EN: Žiadosť sa nepodarila — podrobnosti nájdete v parametri chyby.
EN: Používateľ zrušil žiadosť v aplikácii GP tom.
Chybové kódy relevantné pre login/logout
EN: Neplatné používateľské meno alebo heslo.
EN: Uvedené TID nie je priradené k tomuto používateľovi.
EN: Uvedené TID je už obsadené iným používateľom.
EN: Na tomto zariadení je už prihlásený ten istý používateľ s iným TID.
EN: Prvé prihlásenie – najskôr je potrebné nastaviť heslo.
EN: K tomu dochádza pri prvom prihlásení po kroku 1, keď sa prostredníctvom e-mailu odošle autorizačný kód.
EN: Zadaný potvrdzovací kód na zmenu hesla je neplatný.
EN: Nepodarilo sa prihlásiť používateľa.
EN: Boli odoslané nesprávne prihlasovacie údaje.
EN: Nastavenie terminálu sa nepodarilo. Obraťte sa na našu technickú podporu.
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.