Începând cu versiunea 1.15 a aplicației, vă puteți autentifica și deconecta direct din propriul sistem, utilizând API-ul de tip „deeplink”. Această funcționalitate de autentificare/deconectare directă prin API elimină necesitatea ca personalul să comute la aplicația independentă GP tom și să introducă manual datele de autentificare; acum puteți gestiona întregul proces din cadrul propriei aplicații. Astfel, se reduce timpul necesar pentru activarea terminalului, scad solicitările de asistență legate de autentificare și – cel mai important – se simplifică fluxurile de lucru care implică rotația frecventă a personalului sau a dispozitivelor (cum ar fi schimburile din domeniul ospitalității sau al comerțului cu amănuntul, ori situațiile în care curierii utilizează în comun terminalele între schimburi).
Conectați-vă la aplicație
Cerere
Cale deeplink: gptom://login
Exemplu de apel:
gptom://login?
username=merchant%40example.com&
password=silneheslo&
tid=123456&
redirectUrl=gp%3A%2F%2Flogin
Dacă starea ERROR returnează error=passwordChangeRequired, acest lucru indică prima autentificare a utilizatorului, iar fluxul descris mai jos trebuie urmat.
Conectarea inițială la aplicație cu schimbarea parolei
Dacă utilizatorul nu a setat încă o parolă pentru autentificarea prin deeplink (la prima autentificare), apelul de autentificare returnează eroarea `passwordChangeRequired`. În acest caz, este necesară trimiterea unui deeplink de tip `change-password` în doi pași.
Cerere
Cale deep link: gptom://change-password
Pasul 1 – fără a solicita un cod de verificare
Un apel fără parametrul Code. În caz de succes (status=COMPLETED, fără erori), sistemul trimite un cod de verificare pe adresa de e-mail a utilizatorului.
gptom://change-password?
username=merchant%40example.com&
password=silneheslo&
newPassword=NoveSilneHeslo1&
tid=123456&
redirectURL=gp%3A%2F%2Fchange-password
Pasul 2 – Confirmare prin cod
Aceeași solicitare, incluzând parametrul code transmis prin e-mail. Dacă operațiunea reușește, parola este schimbată și puteți efectua o autentificare standard.
gptom://change-password?
username=merchant%40example.com&
password=silneheslo&
newPassword=NoveSilneHeslo1&
tid=123456&
code=AsfweWW41515&
redirectURL=gp%3A%2F%2Fchange-password
Deconectarea din aplicație
Cerere
Cale deeplink: gptom://logout
gp://logout?redirectUrl=gp%3A%2F%2Flogout
Coduri de stare
EN: Request completed successfully.
EN: Request failed — see the error parameter for details.
EN: User cancelled the request inside the GP tom app.
Coduri de eroare relevante pentru autentificare/deconectare
RO: Nume de utilizator sau parolă invalide.
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.
Verificarea stării de autentificare
Pentru a determina dacă utilizatorul este deja autentificat în aplicația GP tom, puteți apela metoda Get status. Această metodă vă permite să obțineți informații actuale despre starea aplicației și despre comerciantul autentificat. Informații detaliate privind utilizarea și implementarea metodei pot fi găsite în documentația iOS pentru metoda Get status.