0 Kč
Prihlásenie / Registrácia
KÚPIŤ
Zobraziť kategórie

Uzávierka

Čo presne je dávka? Každá transakcia, ktorú vytvoríte, patrí do takzvanej dávky. Rovnako ako účtenka, každá dávka má svoje vlastné číslo a je vlastne balíkom transakcií. Prerušenie je administratívna operácia, pri ktorej terminál uzavrie dávku a vyzve systémy na zatvorenie dávky a otvorenie novej. V global payments je možné vidieť zatváracie číslo pre každú transakciu a je možné filtrovať transakcie podľa tohto čísla.

Prihlásenie & autentifikácia

Overenie tokenom JWT sa vyžaduje pre všetky neverejné koncové body. Token (so životnosťou 90 dní) získate prostredníctvom koncového bodu /cloud/oauth/token s nasledujúcimi argumentmi:

Získanie prístupového tokenu

Príklad žiadosti:

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

Príklad odpovede:

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

Obnovenie tokenu

Po uplynutí platnosti access_tokenu je k dispozícii refresh_token.

Príklad žiadosti:

POST {{apiHost}}/api/oauth/token
Authorization: Basic YXRvbTphc2hmdWY0ZTVmYQ==
Content-Type: application/x-www-form-urlencoded

grant_type=refresh_token&refresh_token=GciO…

GPTomAuth

Druh systému zabezpečenia
Schéma autorizácie HTTP
SK
Nosič

Vytvorenie úlohy

Zavolajte na koncový bod POST /v1/úlohy/BATCH a na podanie žiadosti použite CreateCloudTaskTransactionApiRequest s vyplnenými nasledujúcimi informáciami:

Premenná
date
POVINNÝ
apiKey
MANDATORY
tid
POVINNÝ
initiator
POVINNÝ
title
POVINNÝ
Čas na život
Formát
string
string
string
string
string
celé číslo
Popis: __________
Transakcie so starším alebo rovnakým dátumom budú uzavreté. Zahrnuté budú všetky transakcie do tohto dátumu od poslednej úspešnej uzavretej dávky.
API Kľúč nájdete v aplikácii v časti Konto-Cloud API . Používa sa na rozlíšenie prihlásení hlavne v Cloud API .
Cieľový TID pre danú úlohu. TID = ID terminálu, ktoré je jedinečné pre každé zariadenie. Na všetkých nainštalovaných zariadeniach je možné naraz použiť iba jeden TID.
Opis iniciátora by mal byť jedinečný pre každú inštanciu subsystému, ktorá môže iniciovať úlohu. Príklad: "Server XY" alebo "Pokladník 1"
Názov úlohy čitateľný ľudským okom. Mal by obsahovať určitú identifikáciu úlohy.
Príklad: Faktúra 37364FD
Limit pre uplynutie platnosti cloudovej úlohy. Hodnoty z druhého intervalu je možné špecifikovať.
Príklad
2025-12-18T08:21:39.427SA
333W212J3
483590
Pokladňa 12
Lehota 36744
10

Obsah odpovede [CloudTaskDetailApiResponse]:

Možné kódy odpovedí sú:

Odpoveď
RC200
RC403
RC406
RC 502
Správa
OK - Úloha bola zaregistrovaná
Používateľ nie je oprávnený zaregistrovať úlohu na danom termináli
úloha nie je prijateľná pre terminál
Push notifikácia nie je odoslaná
Popis: __________
Úloha bola úspešne vytvorená a bude spracovaná.
Ak sú vaše prihlasovacie údaje API sa nezhodujú s odoslanou hodnotou TID (napríklad ak je vlastník TID iný).
To sa zvyčajne stáva, keď TID nie je schopný spracovať žiadosť.
Push notifikácia nebola odoslaná z dôvodu zlyhania služby na dodávateľskom trhu.
Ako sa správať
Prejdite na ďalší krok v toku transakcií.
Skontrolujte, či ste vyplnili správny TID, a skúste to znova.
Skontrolujte chybové hlásenie.

Nižšie nájdete premenné použité v odpovedi:

Premenná
title
taskId
created
taskClass
status
initiator
contextId
Payload
exceptionId
typ
message
context
Formát
string
string
string
string
string
string
string
object
string
string
string
string
Popis: __________
Názov úlohy čitateľný ľudským okom. Použité z hodnoty požiadavky.
Interné id úlohy
Dátum a čas vytvorenia úlohy.
Trieda užitočného zaťaženiaMonopworthné hodnoty: [TRANSAKCIA, DÁVKA, FIGURÍNA]
Stav cloudovej úlohy. Možné hodnoty: [CREATED, STARTED, INIT_OK, INIT_ERROR, IN_PROGRESS, COMPLETED, CANCELLED, ERROR]
Popis iniciátora na strane klienta. Použité z hodnoty požiadavky.
ID dotknutej cieľovej entity, ak existuje (transactionId / batchId)
Kontextové telo úlohy – v závislosti od úlohyClass
Pseudo-jedinečné ID výnimky. Môže slúžiť ako "ID podpory", ktoré môže používateľ komunikovať s podporou, aby mohol chybu vyšetriť.
Druh výnimky.
Správa o výnimke.
Kontext výnimky. Zistiť viac.
Príklad
Uzaverka 123
dFd3sda
DÁVKA
CREATED
Pokladňa 12
{...}
FujIk6
VALIDATION_EXCEPTION
Príliš slabé heslo
[INSUFFICIENT_DIGIT]:{minimumRequired=1, matchingCharacterCount=0, validCharacters=0123456789, matchingCharacters=}
RC200
YES
YES
YES
YES
YES
YES
YES
YES
NO
NO
NO
NO
RC403
NO
NO
NO
NO
NO
NO
NO
NO
YES
YES
YES
YES
RC406
NO
NO
NO
NO
NO
NO
NO
NO
YES
YES
YES
YES
RC502
NO
NO
NO
NO
NO
NO
NO
NO
YES
YES
YES
YES

Kontrola stavu úlohy

V dalším kroku budete kontrolovat stav tasku na koncovém bodu GET /v1/tasks/{taskID} pomocí požadavku, který zahrnuje:

Premenná
taskId
Formát
string
Popis: __________
Identifikácia úlohy, ktorú ste dostali v rámci predchádzajúceho kroku.
Príklad
dFd3sda

Možné návratové kódy:

Odpoveď
RC200
RC403
Správa
OK – stav úlohy je k dispozícii
Cloudová úloha sa pre aktuálny terminál nenašla.
Správa
Aktualizácia stavu zákazky bola úspešne spracovaná.
Mali by ste skontrolovať ID úlohy a znova odoslať správnu hodnotu.
Popis: __________
Ak nedostanete konečný stav (pozri nižšie), zopakujte tento krok.
Skontrolujte, či ste vyplnili správne ID úlohy, a skúste to znova.

Premenné v odpovedi:

Premenná
title
taskId
created
taskClass
status
initiator
contextID
Payload
exceptionId
typ
message
context
Formát
string
string
string
string
string
string
string
string
string
string
string
Popis: __________
Názov úlohy čitateľný ľudským okom. Používa sa z hodnoty žiadosti o vytvorenie úlohy.
Interná identifikácia úlohy
Dátum a čas vytvorenia úlohy.
Možné hodnoty: [TRANSAKCIA, DÁVKA, FIGURÍNA]
Možné hodnoty: [CREATED, STARTED, INIT_OK, INIT_ERROR, IN_PROGRESS, COMPLETED, CANCELLED, ERROR]
Popis iniciátora na strane klienta. Použité z hodnoty požiadavky.
ID dotknutej cieľovej entity, ak existuje (transactionId / batchId)
Pseudo-jedinečné ID výnimky. Môže slúžiť ako "ID podpory", ktoré môže používateľ komunikovať s podporou, aby mohol vyšetriť akýkoľvek problém.
Druh výnimky.
Správa o výnimke.
Kontext výnimky - viac informácií.
Príklad
Faktúra 36744
dFd3sda
2025-12-18T08:21:39.427SA
DÁVKA
IN_PROGRESS
Pokladňa 12
12DFSFSSF
FujIk6
VALIDATION_EXCEPTION
Príliš slabé heslo
[INSUFFICIENT_DIGIT]:{minimumRequired=1, matchingCharacterCount=0, validCharacters=0123456789, matchingCharacters=}
RC200
YES
YES
YES
YES
YES
YES
YES
YES
NO
NO
NO
NO
RC404
NO
NO
NO
NO
NO
NO
NO
NO
YES
YES
YES
YES

Žiadosť o stav úlohy by sa mala opakovať, kým nedostanete jeden z kódov konečnej odpovede, ktoré sú:

Stav
INIT_ERROR
COMPLETED
CANCELLED
ERROR
Popis: __________
Platobný proces sa nepodarilo inicializovať. Skontrolujte chybu, ktorá sa vám zobrazila.
Po získaní tohto stavu bola úloha dokončená a výsledok je k dispozícii.
Úloha bola používateľom zrušená.
Pri spracovaní zákazky sa vyskytla chyba.
Ako sa správať
Postupujte podľa pokynov na chybu.
Môžete prejsť na ďalší krok.
Mali by ste začať novú prácu, pretože túto úlohu používateľ zrušil.
Postupujte podľa pokynov na chybu.

K ďalšiemu kroku môžete pristúpiť len vtedy, keď je odpoveď v stave DOKONČENÉ.

Získanie záverečného výsledku

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é:

Premenná
batchId
Formát
string
Popis: __________
ID dávky, ktoré získate v predchádzajúcich krokoch.
Príklad
12DFSFSSF

Možné kódy odpovedí sú:

Odpoveď
RC200
RC404
Správa
OK – poskytnuté podrobnosti o zatvorení
Pre súčasný TID nebol stanovený konečný termín.
Správa
Úspešná odpoveď na vašu žiadosť o termín.
Táto podmienka sa vyskytuje, keď sa pre vaše zariadenie nenašiel daný identifikátor dátumu uzávierky.
Popis: __________
Transakcia je dokončená!
Skontrolujte ID transakcie.

Odpoveď obsahuje nasledujúce premenné v závislosti od kódu odpovede:

Premenná
batchid
communicationId
batchNumber
date
previousBatchDate
firstTransactionDate
totalAmount
currency
totalCount
saleCount
saleAmount
voidCount
voidAmount
invalidCount
amsBatchNumber
subBatches
Formát
string
string
string
string
string
string
number
string
number
number
number
number
number
number
string
object
Popis: __________
Interné ID šarže, OTVORENÉ pre pseudo dávku s otvorenými transakciami.
Môže byť použitý na technickú podporu. Pseudo jedinečné ID na účely protokolovania.
Číslo šarže pre TID.
Presný dátum a čas, kedy bola dávka uzavretá.
Dátum a čas začiatku uzavretej dávky. Pre túto dávku máte časové obdobie (OD: previousBatchDate TO: value date).
Dátum najstaršej transakcie.
Celková suma za všetky typy transakcií.
Záverečná mena
Celkový počet transakcií v dávke
Počet predajných transakcií v dávke.
Objem predajných transakcií v dávke.
Počet všetkých storno transakcií v dávke.
Objem všetkých storno transakcií v dávke.
Počet neplatných transakcií v dávke
Interné ID šarže, OTVORENÉ pre pseudo dávku s otvorenými transakciami.
Základné dávky v rámci metadávky – členenie podľa typu transakcie a obsahuje štatistické informácie o podriadených dávkach podľa typu spôsobu platby. Obsahuje:
-closeBatchNumber (reťazec) - closeBatchNumber detská dávka
- totalCount (počet) - Celkový počet transakcií v dávke
- saleCount (číslo) - Počet transakcií typu predaja v dávke
- saleAmount (číslo) - Objem transakcií predajného typu v dávke
- voidCount (počet) - Počet zrušených transakcií
- voidAmount (číslo) - Objem zrušenia transakcie v dávke
Príklad
12DFSFSSF
2
2025-12-18T08:21:39.427SA
2025-12-17T12:22:11.427SA
Ako sa vám páči tento tutoriál?