Az alkalmazás 1.75.2-es verziója és az AIDL könyvtár 1.28-as verziója óta az app2app API segítségével közvetlenül a rendszeredből is be- és kijelentkezhetsz az alkalmazásba. Lehetőség van a terminál feloldására is, ha az már használatban volt egy másik eszközön.

Bejelentkezés az alkalmazásba

Kérés

A bemeneti értékek a LoginEntityben json formátumban szereplő paraméterek:

Kötelező attribútumok:

• • felhasználónév: email a GP TOM bejelentkezéshez
  • jelszó: jelszó a GP TOM alkalmazás felhasználójának jelszava
  • terminalId: TID/ terminál azonosító

Választható attribútumok:

• authCode: A foglalt TID felszabadításához használt hitelesítési kód.

void login(String felhasználónév, String jelszó, String terminalId)

LoginEntity(

Válasz - államok

Az alábbi táblázat felsorolja a lehetséges státuszokat. Sikeres státusznak minősül USER_LOGGED_IN vagy TID_ASSIGNED_AND_LOGGED_IN.

Ha a következő státuszkódot kapja TID_RELEASE_REQUEST, újra meg kell hívnia a bejelentkezési API-t, és ezúttal a következő paramétert kell megadnia authCode, amelyet automatikusan elküldünk az Ön e-mail címére. A rendszer ezután visszaküldi a státuszt TID_ASSIGNED_AND_LOGGED_IN - a rendszer hozzárendel egy TID-t a felhasználóhoz, és bejelentkezik.

A fennmaradó állapotok a hibaállapotot és a hiba okát jelzik.

Ha a státusz a bejelentkezés részeként kerül visszaadásra PASSWORD_CHANGE_REQUIRED, ez az első bejelentkezés, ahol először meg kell változtatnia a jelszavát.

Első bejelentkezés az alkalmazásba jelszóváltoztatással

Ha állapotjelentést kap PASSWORD_CHANGE_REQUIRED, ez a felhasználó első bejelentkezése, és új jelszót kell beállítani. Az új jelszó beállítása két lépésben történik.

void changePassword (String oldPass, String newPass, String authCode, boolean validationOnly)

Az első lépésben az attribútumok kerülnek kitöltésre a kérelemben:

• oldPass - kezdeti felhasználói jelszó
• newPass - új felhasználói jelszó
• authCode - nulla
• validationOnly - igaz

Ez egy engedélyezési kódot generál, amelyet elküld az e-mailben. Ennek a lépésnek a részeként a státusz visszakerül Önhöz. PASSWORD_PENDING_CONFIRMATION.

Kijelentkezés az alkalmazásból

Az app2app API-n belül lehetőség van arra is, hogy a felhasználó egy kiválasztott TID-ről végponton keresztül leiratkozzon.

Sikeres kijelentkezés után az Ön állapota visszakerül Önhöz. USER_LOGGED_OUT. Ha a kijelentkezés hibát eredményez, akkor a következő állapotot kapja vissza LOGOUT_FAILED.

Felhasználási példák

Bejelentkezés

val intent = Intent(„com.globalpayments.atom.BIND_TO_LOGIN_SERVICE“) context.bindService(intent, connection, Context.BIND_AUTO_CREATE)

Jelszó módosítása

// 1. lépés - érvényesítés (kérés kódja)

val changePasswordValidationEntity = ChangePasswordEntity(

/* oldPass = */ currentPassword,

/* newPass = */ newPassword,

/* authCode = */ null,

/* validationOnly = */ true,
)
service?.changePassword(Gson().toJson(changePasswordValidationEntity))

// 2. lépés - új jelszó alkalmazása kóddal

val changePasswordEntity = ChangePasswordEntity(

/* oldPass = */ currentPassword,

/* newPass = */ newPassword,

/* authCode = */ authCode,

/* validationOnly = */ false,
)
service?.changePassword(Gson().toJson(changePasswordEntity))

Kijelentkezés

service?.logout()

Állapot kódok