Počevši od verzije aplikacije 1.15, možete se prijaviti u aplikaciju i odjaviti iz nje izravno putem vlastitog sustava koristeći API za duboke poveznice (deeplink API). Ova mogućnost izravne prijave i odjave putem API-ja uklanja potrebu da se osoblje prebacuje na zasebnu aplikaciju GP tom i ručno unosi podatke za prijavu – sada cijeli proces možete voditi unutar vlastite aplikacije. Time se skraćuje vrijeme potrebno za aktivaciju terminala, smanjuje broj upita korisničkoj podršci vezanih uz prijavu te – što je najvažnije – pojednostavnjuju radni procesi koji uključuju česte izmjene osoblja ili uređaja (poput smjena u ugostiteljstvu i maloprodaji ili kurira koji dijele terminale između smjena).
Prijavite se u aplikaciju
Zahtjev
Putanja duboke poveznice: gptom://login
Primjer poziva:
gptom://login?
username=merchant%40example.com&
password=silneheslo&
tid=123456&
redirectUrl=gp%3A%2F%2Flogin
Ako stanje ERROR vraća error=passwordChangeRequired, to označava prvu prijavu korisnika te se mora slijediti postupak opisan u nastavku.
Prvo prijavljivanje u aplikaciju uz promjenu lozinke
Ako korisnik još nije postavio lozinku za prijavu putem duboke poveznice (prijava pri prvom korištenju), poziv za prijavu vraća pogrešku `passwordChangeRequired`. U tom slučaju potrebno je poslati duboku poveznicu za promjenu lozinke (`change-password`) u dva koraka.
Zahtjev
Putanja duboke poveznice: gptom://change-password
1. korak – bez traženja koda za potvrdu
Poziv bez parametra Code. U slučaju uspjeha (status=COMPLETED, bez pogreške), sustav šalje kod za potvrdu na e-adresu korisnika.
gptom://change-password?
username=merchant%40example.com&
password=silneheslo&
newPassword=NoveSilneHeslo1&
tid=123456&
redirectURL=gp%3A%2F%2Fchange-password
Korak 2 – Potvrda putem koda
Istovremeni poziv, uključujući parametar code poslan e-poštom. Nakon uspješne operacije lozinka je promijenjena i možete nastaviti sa standardnom prijavom.
gptom://change-password?
username=merchant%40example.com&
password=silneheslo&
newPassword=NoveSilneHeslo1&
tid=123456&
code=AsfweWW41515&
redirectURL=gp%3A%2F%2Fchange-password
Odjavi se iz aplikacije
Zahtjev
Putanja duboke poveznice: gptom://logout
gp://logout?redirectUrl=gp%3A%2F%2Flogout
Kodovi statusa
EN: Request completed successfully.
EN: Request failed — see the error parameter for details.
EN: User cancelled the request inside the GP tom app.
Kodovi pogrešaka povezani s prijavom i odjavom
EN: Neispravno korisničko ime ili lozinka.
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.
Provjera statusa prijave
Kako biste utvrdili je li korisnik već prijavljen u aplikaciju GP tom, možete pozvati metodu Get status. Ova metoda omogućuje dohvaćanje trenutačnih informacija o statusu aplikacije i prijavljenom trgovcu. Detaljne informacije o upotrebi i implementaciji metode možete pronaći u iOS dokumentaciji za metodu Get status.