Mi is pontosan az a dózis? Minden egyes létrehozott tranzakció egy adaghoz tartozik. A nyugtához hasonlóan minden egyes tételnek van egy száma, és valójában tranzakciók csomagja. A lezárás egy adminisztrációs művelet, amelynek során a terminál lezár egy tételt, és felszólítja a rendszereket, hogy zárják le a tételt, és nyissanak egy újat. A globális fizetési rendszerekben lehetőség van arra, hogy minden egyes tranzakció zárószámát lássa, és a tranzakciókat e szám alapján szűrni lehessen.

Bejelentkezés és hitelesítés

Minden nem nyilvános végpont esetében JWT-token hitelesítésre van szükség. A token (90 napos élettartammal) a /cloud/oauth/token végponton keresztül érhető el a következő argumentumok megadásával:

• Alapszintű hitelesítés a token végpontokhoz (név/jelszó) - minden felhasználó számára biztosított.
• Kereskedő felhasználónév - ugyanaz, mint a Genius mobile pay esetében
• Kereskedői jelszó - ugyanaz, mint a Genius mobile pay esetében
• Terminal ID (TID) - a célterminál azonosítója.
• Az engedélyezési végpont a következő címen található:
  • Dev: https://cloud-api-dev.gptom.com/cloud/oauth/token
  • gyártás: https://cloud-api.gptom.com/cloud/oauth/token

Hozzáférési token megszerzése

A kérelem tárgya:

Példa kérés:

curl --location '{{apiCloudHost}}/cloud/oauth/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Basic YXRvbTphc2hmdWY0ZTVmYQ==' \

--data-urlencode 'grant_type=password' \
--data-urlencode 'password=ABCDEFGHIJKL' \
--data-urlencode 'username=jan.novak@example.com' \
--data-urlencode 'tid=999888'

Példa válaszra:

{
"access_token": "eyJh…", // access token used in authenticated API requests
"token_type": "bearer",
"refresh_token": "GciO…",
"expires_in": 3600,
"scope": "read write",
"tid": "999888",
}

Egy token megújítása

Amikor a access_token lejár, egy refresh_token áll rendelkezésre.

Példa kérés:

POST {{apiHost}}/api/oauth/token
Engedélyezés: Alapvető YXRvbTphc2hmdWY0ZTVmYQ==
Content-Type: application/x-www-form-urlencoded

grant_type=refresh_token&refresh_token=GciO...

GPTomAuth

Táska létrehozása

Hívja meg a /v1/tasks/BATCH POST végpontot, és használja a CreateCloudTaskTransactionApiRequest parancsot a következő információkkal a kérelem létrehozásához:

A [CloudTaskDetailApiResponse] tartalma:

A lehetséges válaszkódok a következők:

Az alábbiakban a válaszban használt változókat ismertetjük:

Ellenőrizze a táska állapotát

A következő lépésben a GET /v1/tasks/{taskID} végponton ellenőrizni fogja a feladat állapotát egy olyan kéréssel, amely a következőket tartalmazza:

Lehetséges visszatérési kódok:

Válaszváltozók:

A zsák állapotára vonatkozó kérést addig kell ismételni, amíg meg nem kapjuk a végső válaszkódok egyikét, amelyek a következők:

Csak akkor léphet tovább a következő lépésre, ha a válasz KÉSZ állapotú.

A záró eredmény elérése

Most már tudjuk, hogy a bezárást engedélyezték. Ennek a lépésnek az a célja, hogy a határidő és adatai állapotát megkapjuk. Az új kéréshez hívja meg a GET /v1/batches/{batchId} végpontot a következő változók használatával:

A lehetséges válaszkódok a következők:

A válasz a válaszkódtól függően a következő változókat tartalmazza: