Począwszy od wersji aplikacji 1.15, możesz logować się do aplikacji i wylogowywać z niej bezpośrednio z poziomu własnego systemu, korzystając z API typu deeplink. Ta możliwość bezpośredniego logowania i wylogowywania eliminuje konieczność przełączania się personelu na samodzielną aplikację GP tom i ręcznego wprowadzania danych uwierzytelniających – cały proces można teraz zarządzać z poziomu własnej aplikacji. Rozwiązanie to skraca czas potrzebny na aktywację terminala, ogranicza liczbę zgłoszeń do pomocy technicznej związanych z logowaniem, a co najważniejsze – usprawnia procedury w sytuacjach wymagających częstej rotacji personelu lub urządzeń (np. przy zmianach w gastronomii i handlu czy w przypadku kurierów korzystających z tych samych terminali na różnych zmianach).
Zalogowanie się do aplikacji
Żądanie
Ścieżka głębokiego linku: gptom://login
Przykład połączenia:
gptom://login?
username=merchant%40example.com&
password=silneheslo&
tid=123456&
redirectUrl=gp%3A%2F%2Flogin
Jeśli stan ERROR zwraca wartość error=passwordChangeRequired, oznacza to pierwsze logowanie użytkownika i konieczne jest postępowanie zgodnie z poniższym opisem procesu.
Pierwsze zalogowanie się do aplikacji i zmiana hasła
Jeśli użytkownik nie ustawił jeszcze hasła do logowania przez deeplink (logowanie po raz pierwszy), żądanie logowania zwraca błąd `passwordChangeRequired`. W takim przypadku konieczne jest przesłanie deeplinka `change-password` w dwóch krokach.
Żądanie
Ścieżka głębokiego linku: gptom://change-password
Krok 1 – bez żądania kodu weryfikacyjnego
Wywołanie bez parametru Code. W przypadku powodzenia (status=COMPLETED, brak błędu) system wysyła kod weryfikacyjny na adres e-mail użytkownika.
gptom://change-password?
username=merchant%40example.com&
password=silneheslo&
newPassword=NoveSilneHeslo1&
tid=123456&
redirectURL=gp%3A%2F%2Fchange-password
Krok 2 – Potwierdzenie kodem
To samo wywołanie, uwzględniające parametr code przesłany w wiadomości e-mail. Po pomyślnym zakończeniu operacji hasło zostaje zmienione i można przejść do standardowego logowania.
gptom://change-password?
username=merchant%40example.com&
password=silneheslo&
newPassword=NoveSilneHeslo1&
tid=123456&
code=AsfweWW41515&
redirectURL=gp%3A%2F%2Fchange-password
Wylogowywanie się z aplikacji
Żądanie
Ścieżka głębokiego linku: gptom://logout
gp://logout?redirectUrl=gp%3A%2F%2Flogout
Kody stanu
EN: Request completed successfully.
EN: Request failed — see the error parameter for details.
EN: User cancelled the request inside the GP tom app.
Kody błędów związane z logowaniem i wylogowywaniem
EN: Nieprawidłowa nazwa użytkownika lub hasło.
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.
Weryfikacja statusu logowania
Aby sprawdzić, czy użytkownik jest już zalogowany w aplikacji GP tom, można wywołać metodę Get status. Metoda ta umożliwia pobranie aktualnych informacji o stanie aplikacji oraz o zalogowanym akceptancie. Szczegółowe informacje na temat użycia i implementacji tej metody znajdują się w dokumentacji metody Get status dla systemu iOS.