Î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&
parola=parolăputernică&
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&
parola=parolăputernică&
newPassword=ParolăNouăȘiPuternică1&
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&
parola=parolăputernică&
newPassword=ParolăNouăȘiPuternică1&
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: Cererea a fost finalizată cu succes.
EN: Cererea a eșuat — consultați parametrul de eroare pentru detalii.
EN: Utilizatorul a anulat solicitarea din aplicația GP tom.
Coduri de eroare relevante pentru autentificare/deconectare
RO: Nume de utilizator sau parolă invalide.
EN: TID-ul furnizat nu este atribuit acestui utilizator.
EN: TID-ul furnizat este deja ocupat de un alt utilizator.
EN: Același utilizator este deja conectat pe acest dispozitiv cu un TID diferit.
EN: Prima autentificare – trebuie să setați mai întâi o parolă.
EN: Acest lucru se întâmplă la prima autentificare după pasul 1, când se trimite un cod de autorizare prin e-mail.
EN: Codul de confirmare furnizat pentru schimbarea parolei nu este valid.
EN: Nu a fost posibilă autentificarea utilizatorului.
EN: Au fost trimise date de autentificare incorecte.
EN: Configurarea terminalului a eșuat. Vă rugăm să contactați serviciul nostru de asistență.
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.