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 GP tom esetében
- Kereskedői jelszó - ugyanaz, mint a GP tom 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ó:
Hozzáférési token megszerzése
Példa kérésre:
POST {{apiCloudHost}}/cloud/oauth/token
Authorization: Basic YXRvbTphc2hmdWY0ZTVmYQ==
Content-Type: application/x-www-form-urlencoded
grant_type=password&username=jan.novak@example.com&password=ABCDEFGHIJKL&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ésre:
POST {{apiHost}}/api/oauth/token
Authorization: Basic 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:
KÖTELEZŐ
KÖTELEZŐ
KÖVETELMÉNYEK
KÖVETELMÉNYEK
KÖTELEZŐ
Példa: "Invoice 37364FD"
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
V dalším kroku budete kontrolovat stav tasku na koncovém bodu GET /v1/tasks/{taskID} pomocí požadavku, který zahrnuje:
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
Nyní víme, že uzávěrka byla autorizována. Cílem tohoto kroku je získat stav uzávěrky a její údaje. Pro nový požadavek zavoláte koncový bod GET /v1/batches/{batchId}, kde použijete následující proměnné:
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:
-closeBatchNumber (string) - closeBatchNumber of the child batch
- totalCount (number) - A tranzakciók teljes száma a tételben
- saleCount (number) - Az értékesítés típusú tranzakciók száma a tételben
- saleAmount (number) - Az értékesítés típusú tranzakciók mennyisége a tételben
- voidCount (number) - A tranzakciók törlésének száma
- voidAmount (number) - A tranzakciók törlésének mennyisége a tételben.