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&
lozinka=strongpassword&
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&
lozinka=strongpassword&
novaLozinka=NovaSnažnaLozinka1&
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&
lozinka=strongpassword&
novaLozinka=NovaSnažnaLozinka1&
tid=123456&
kod=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: Zahtjev je uspješno dovršen.
Zahtjev je propao — pogledajte parametar error za detalje.
EN: Korisnik je otkazao zahtjev u aplikaciji GP tom.
Kodovi pogrešaka povezani s prijavom i odjavom
EN: Neispravno korisničko ime ili lozinka.
EN: TID koji je dostavljen nije dodijeljen ovom korisniku.
EN: TID koji je naveden već je u upotrebi kod drugog korisnika.
EN: Isti korisnik je već prijavljen na ovom uređaju s drugim TID-om.
EN: Prvo prijavljivanje – prvo morate postaviti lozinku.
EN: Ovo se događa prvi put kada se prijavite nakon koraka 1, kada se kod za autorizaciju pošalje e-poštom.
EN: Kôd za potvrdu za promjenu lozinke je nevažeći.
EN: Nije bilo moguće prijaviti korisnika.
EN: Pošlane su netočne vjerodajnice.
Postavljanje terminala nije uspjelo. Molimo kontaktirajte naš tim za podršku.
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.