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=NoweSilneHasło1&
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=NoweSilneHasło1&
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: Żądanie zostało pomyślnie zrealizowane.
EN: Żądanie nie powiodło się — szczegóły znajdują się w parametrze błędu.
EN: Użytkownik anulował żądanie w aplikacji GP tom.
Kody błędów związane z logowaniem i wylogowywaniem
EN: Nieprawidłowa nazwa użytkownika lub hasło.
EN: Podany identyfikator TID nie jest przypisany do tego użytkownika.
EN: Podany identyfikator TID jest już zajęty przez innego użytkownika.
EN: Ten sam użytkownik jest już zalogowany na tym urządzeniu przy użyciu innego identyfikatora TID.
EN: Pierwsze logowanie – najpierw należy ustawić hasło.
EN: Dzieje się to przy pierwszym logowaniu po wykonaniu kroku 1, kiedy kod autoryzacyjny jest wysyłany pocztą elektroniczną.
EN: Podany kod potwierdzający do zmiany hasła jest nieprawidłowy.
EN: Nie udało się zalogować użytkownika.
EN: Przesłano nieprawidłowe dane uwierzytelniające.
EN: Nie udało się skonfigurować terminala. Prosimy o kontakt z naszym działem pomocy technicznej.
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.