Az értékesítési tranzakció egy olyan alapvető fizetési művelet, amely egy meghatározott összeget utal át a kártyabirtokos bankszámlájáról a kereskedő számlájára.
Ami a fizetési folyamatot illeti, az eljárás a következő:
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ó:
Ez a hitelesítési módszer minden terminál esetében azonos.
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
(Authorization a Contect-Type je pro všechny zákazníky vždy stejný – použijte prosím stejné údaje jako v příkladu. Do grant_type je potřeba následně vložit unikátní údaje klienta).
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/TRANSACTION POST végpontot, és használja a CreateCloudTaskTransactionApiRequest funkciót a következő információk kitöltésével a kérelem létrehozásához:
KÖTELEZŐ
KÖVETELMÉNYEK
KÖVETELMÉNYEK
KÖTELEZŐ
Példa: "Számla 37364FD".
True, ha a nyugtát ki kell nyomtatni a készülékre.
Megjegyzés: Mobiltelefonok esetében meg kell győződnie arról, hogy a Bluetooth-nyomtató csatlakoztatva van.
KÖTELEZŐ
MANDATORY
Lehetséges értékek: [ LAST_TRANSACTION, OLDER_TRANSACTION ]
MANDATORY
Ha igazra van állítva, akkor a GP tom-ban a borravaló beviteli képernyő lesz először meghívva.
Ahhoz, hogy ezt a képernyőt meghívja, a borravalónak is engedélyezve kell lennie az alkalmazásban.
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 fizetési eredmény elérése
Nyní víme, že transakce byla autorizována. Cílem tohoto kroku je získat stav transakce a detaily transakce. Pro nový požadavek zavoláte koncový bod GET /v1/transactions/{transactionId}, 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:
ELFOGADVA - a tranzakciót sikeresen engedélyezték
ELMARADVA - a tranzakciót valamilyen okból elutasították
ELMARADVA - ha a tranzakciót az üzemeltető vagy az ügyfél törölte.
Művelet / tranzakció típusa."
Ha a nyugtát Ön fogja generálni vagy kinyomtatni, javasoljuk, hogy ellenőrizze, mely mezők kötelezőek, és melyeket kell kinyomtatni/megjeleníteni a nyugtán. A leírás rendelkezésre áll itt:.