Începând cu versiunea 1.75.2 a aplicației și biblioteca AIDL 1.28, este posibilă conectarea/ deconectarea la aplicație direct din sistemul dvs. utilizând API-ul app2app. De asemenea, este posibilă deblocarea terminalului dacă acesta a fost deja utilizat pe un alt dispozitiv.
Conectați-vă la aplicație
Cerere
Valorile de intrare sunt parametri care sunt conținuți ca json în LoginEntity:
Atribute obligatorii:
-
- nume de utilizator: e-mail pentru a vă conecta la GP TOM
- parolă: parola pentru utilizatorul aplicației GP TOM
- terminalId: TID/ id terminal
Atribute opționale:
- Codul de autentificare: Codul de autentificare care este utilizat pentru eliberarea TID ocupat
void login(String username, String password, String terminalId)
LoginEntity(
/* nume utilizator = */ nume utilizator,
/* parola = */ parola,
/* terminalId = */ terminalId,
/* authCode = */ authCode
)
Răspuns - state
Tabelul de mai jos enumeră statusurile pe care le puteți primi. O stare de succes este considerată a fi USER_LOGGED_IN sau TID_ASSIGNED_AND_LOGGED_IN.
În cazul în care primiți un cod de stare TID_RELEASE_REQUEST, trebuie să apelați din nou API-ul de conectare și de data aceasta să completați parametrul Codul de autentificare, care este trimis automat la adresa dvs. de e-mail. Sistemul returnează apoi starea TID_ASSIGNED_AND_LOGGED_IN - Sistemul atribuie un TID utilizatorului și îl conectează.
Celelalte stări indică starea de eroare și motivul erorii.
Dacă starea este returnată ca parte a autentificării PAROLA_SCHIMBARE_REQUIRED, aceasta este prima autentificare la care trebuie să vă schimbați parola.
Conectarea inițială la aplicație cu schimbarea parolei
Dacă primiți un status PAROLA_SCHIMBARE_REQUIRED, aceasta este prima autentificare a utilizatorului și trebuie setată o nouă parolă. Noua parolă este setată în doi pași.
void changePassword (String oldPass, String newPass, String authCode, boolean validationOnly)
În prima etapă, atributele sunt completate în cerere:
- vechiPass - parola inițială a utilizatorului
- newPass - parolă utilizator nou
- Codul de autentificare - nul
- numai validare - adevărat
Acest lucru generează un cod de autorizare care este trimis la adresa de e-mail. Ca parte a acestui pas, statusul vă este returnat PAROLĂ_ÎN AȘTEPTARE_CONFIRMARE.
Codul de autorizare trebuie utilizat în a doua etapă, în care atributele sunt completate după cum urmează:
- vechiPass - parola inițială a utilizatorului
- newPass - parolă utilizator nou
- Codul de autentificare - cod trimis la adresa dvs. de e-mail
- numai validare - fals
Dacă codul de validare este corect, statusul vă este returnat PAROLĂ_SCHIMBATĂ. În acest moment, parola utilizatorului a fost modificată și îl puteți conecta la aplicație.
Deconectarea din aplicație
În cadrul API-ului app2app, este posibilă, de asemenea, dezabonarea unui utilizator de la un TID selectat prin intermediul unui endpoint.
void logout()
După o deconectare reușită, statutul dvs. vă este returnat USER_LOGGED_OUT. Dacă deconectarea duce la o eroare, se returnează starea LOGOUT_FAILED.
Exemple de utilizare
Autentificare
val intent = Intent(„com.globalpayments.atom.BIND_TO_LOGIN_SERVICE“) context.bindService(intent, connection, Context.BIND_AUTO_CREATE)
service?.registerCallback(callback)
val loginEntity = LoginEntity(
/* nume utilizator = */ nume utilizator,
/* parola = */ parola,
/* terminalId = */ terminalId,
/* authCode = */ authCode
)
service?.login(Gson().toJson(loginEntity))
Modificarea parolei
// Etapa 1 - validarea (codul cererii)
val changePasswordValidationEntity = ChangePasswordEntity(
/* oldPass = */ currentPassword,
/* newPass = */ newPassword,
/* authCode = */ null,
/* validationOnly = */ true,
)
service?.changePassword(Gson().toJson(changePasswordValidationEntity))
// Pasul 2 - aplicarea noii parole cu cod
val changePasswordEntity = ChangePasswordEntity(
/* oldPass = */ currentPassword,
/* newPass = */ newPassword,
/* authCode = */ authCode,
/* validationOnly = */ false,
)
service?.changePassword(Gson().toJson(changePasswordEntity))
Ieșire
service?.logout()
Coduri de stare
RO: Utilizatorul s-a conectat cu succes.
RO: Utilizatorul s-a deconectat cu succes.
RO: Tentativa de conectare a eșuat.
RO: Tentativa de deconectare a eșuat.
RO: Nume de utilizator sau parolă invalide.
RO: Parametru lipsă sau invalid.
RO: ID-ul terminalului nu este legat de acest utilizator.
RO: Un alt TID/utilizator este activ pe acest dispozitiv.
RO:Terminal atribuit cu succes și utilizator conectat.
RO: ID-ul terminalului nu a fost găsit.
EN: ID-ul terminalului este inactiv sau dezactivat.
RO: Nu a fost selectat niciun terminal pentru această sesiune.
RO: Dacă ID-ul terminalului este deja ocupat de altcineva și nu este furnizat niciun cod de autorizare, serviciul va solicita un cod de autorizare pentru a elibera TID-ul.
RO: A fost furnizat un authCode greșit pentru eliberarea TID.
RO: Utilizatorul trebuie să schimbe parola înainte de conectare.
RO: Cod de confirmare trimis pentru schimbarea parolei.
RO: Parola a fost schimbată cu succes.
RO: Încercarea de schimbare a parolei a eșuat.