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és:
POST {{apiCloudHost}}/cloud/oauth/token
Engedélyezés: Alapvető 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...", // hitelesített API-kérésekben használt hozzáférési token
"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:
KÖTELEZŐ
KÖTELEZŐ
KÖTELEZŐ
KÖTELEZŐ
KÖTELEZŐ
Példa: „Számla 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
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:
-closeBatchNumber (string) – az aladag closeBatchNumber értéke
- totalCount (number) – A tételben szereplő tranzakciók teljes száma
- saleCount (number) – Az eladási típusú tranzakciók száma a tételben
- saleAmount (szám) – az adagban szereplő értékesítési típusú tranzakciók összege
- voidCount (szám) – a törölt tranzakciók száma
- voidAmount (szám) – az adagban szereplő törölt tranzakciók összege