Što je točno serija? Svaka transakcija koju kreirate pripada takozvanoj seriji. Baš kao i račun, svaka serija ima svoj broj i u biti je paket transakcija. Zatvaranje je administrativna operacija kojom terminal zatvara seriju i potiče sustave da zatvore seriju i otvore novu. U Global Payments sustavima moguće je vidjeti broj zatvaranja za svaku transakciju i filtrirati transakcije prema tom broju.
Prijava i autentifikacija
Sve nejavne krajnje točke zahtijevaju autentifikaciju pomoću JWT tokena. Token (s vijekom trajanja od 90 dana) možete dobiti putem krajnje točke /cloud/oauth/token sa sljedećim argumentima:
- Osnovna autentifikacija za krajnje točke tokena (ime/lozinka) – bit će osigurana za svakog korisnika.
- Korisničko ime trgovca – isto kao i za GP tom
- Lozinka trgovca – ista kao i za GP tom
- ID terminala (TID) – ID ciljnog terminala
- Krajnja točka autorizacije nalazi se na:
Dobivanje pristupnog tokena
Primjer zahtjeva:
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
Primjer odgovora:
{
"access_token": "eyJh…", // access token used in authenticated API requests
"token_type": "bearer",
"refresh_token": "GciO…",
"expires_in": 3600,
"scope": "read write",
"tid": "999888",
}Oporavak tokena
Nakon isteka access_tokena, dostupan je refresh_token.
Primjer zahtjeva:
POST {{apiHost}}/api/oauth/token
Authorization: Basic YXRvbTphc2hmdWY0ZTVmYQ==
Content-Type: application/x-www-form-urlencoded
grant_type=refresh_token&refresh_token=GciO…
GPTomAuth
Vrsta sigurnosne sheme
HTTP autorizacijska shema
HTTP
bearer
Izrada zadatka
Zavolejte koncový bod POST /v1/tasks/BATCH a použijte CreateCloudTaskTransactionApiRequest s následujícími údaji vyplněnými k vytvoření požadavku:
Varijabla
date
OBAVEZNO
OBAVEZNO
apiKey
OBAVEZNO
OBAVEZNO
tid
OBAVEZNO
OBAVEZNO
initiator
OBAVEZNO
OBAVEZNO
title
OBAVEZNO
OBAVEZNO
timeToLive
Format
niz
niz
niz
niz
niz
integer
Opis
Transakcije sa starijim ili istim datumom bit će zatvorene. Bit će uključene sve transakcije do tog datuma od posljednje uspješno zatvorene serije.
API ključ možete pronaći u aplikaciji u odjeljku Account-Cloud API. Koristi se za razlikovanje prijava uglavnom u Cloud API-ju.
Ciljani TID za zadatak. TID = ID terminala, koji je jedinstven za svaki uređaj. Samo jedan TID može se koristiti istovremeno na svim instaliranim uređajima.
Opis inicijatora trebao bi biti jedinstven za svaku instancu podsustava koja može pokrenuti zadatak. Primjer: "poslužitelj XY" ili "Blagajnik 1"
Naziv zadatka koji ljudi mogu pročitati. Trebao bi sadržavati neku identifikaciju zadatka.
Primjer: "Dostavnica 37364FD"
Primjer: "Dostavnica 37364FD"
Vremensko ograničenje isteka zadatka u oblaku. Dopuštene su vrijednosti od sekundi.
Primjer
2025-12-18T08:21:39.427Z
333W212J3
483590
Cash desk 12
Zaključivanje serije 36744
10
Sadržaj odgovora [CloudTaskDetailApiResponse]:
Mogući kodovi odgovora su:
Odgovor
RC200
RC403
RC406
RC 502
Poruka
OK - Zadatak je registriran
Korisniku nije dopušteno registrirati posao na danom terminalu.
Zadatak nije prihvatljiv za zadani terminal.
Push notification nije poslana
Opis
Zadatak je uspješno kreiran i bit će obrađen.
Ako se vaši API podaci ne podudaraju s poslanom TID vrijednošću (na primjer, kada je vlasnik TID-a drugačiji).
To se obično događa kada TID ne može obraditi zahtjev.
Push notification nije poslano zbog kvara uzvodne usluge.
Što učiniti
Nastavite sa sljedećim korakom u tijeku transakcije.
Molimo provjerite jeste li unijeli ispravan TID i pokušajte ponovno.
Provjerite poruku o pogrešci.
U nastavku možete pronaći varijable korištene u odgovoru:
Varijabla
title
taskId
created
taskClass
status
initiator
contextId
payload
exceptionId
type
message
context
Format
niz
niz
niz
niz
niz
niz
niz
object
niz
niz
niz
niz
Opis
Naziv zadatka koji ljudi mogu pročitati. Koristi se iz vrijednosti zahtjeva.
Interní id tasku
Datum i vrijeme kada je zadatak kreiran.
Třída užitečného zatíženíMožné hodnoty: [TRANSACTION, BATCH, DUMMY]
Status zadatka u oblaku. Moguće vrijednosti: [CREATED, STARTED, INIT_OK, INIT_ERROR, IN_PROGRESS, COMPLETED, CANCELLED, ERROR]
Opis inicijatora na strani klijenta. Koristi se iz vrijednosti zahtjeva.
ID pogođenog ciljnog entiteta, ako postoji (transactionId / batchId)
Tijelo kontekstualnog zadatka - ovisno o taskClass
Pseudo-jedinstveni ID iznimke. Može poslužiti kao "ID podrške" koji korisnik može dati podršci kako bi istražila pogrešku.
Vrsta iznimke.
Izvješće o iznimci.
Kontekst iznimke. Više informacija.
Primjer
Uzaverka 123
dFd3sda
BATCH
STVORENO
Cash desk 12
{...}
FujIk6
VALIDATION_EXCEPTION
Password too weak
[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
Provjera statusa zadatka
U sljedećem koraku provjerit ćete status zadatka na krajnjoj točki GET /v1/tasks/{taskID} koristeći zahtjev koji uključuje:
Varijabla
taskId
Format
niz
Opis
ID zadatka koji ste primili kao dio prethodnog koraka.
Primjer
dFd3sda
Mogući povratni kodovi:
Odgovor
RC200
RC403
Poruka
OK - Dostupan status zadatka
Zadatak u oblaku nije pronađen za trenutni terminal.
Poruka
Ažuriranje statusa posla uspješno je obrađeno.
Trebali biste provjeriti svoj ID zadatka i ponovno poslati ispravnu vrijednost.
Opis
Ako ne dobijete konačni status (vidi dolje), ponovite ovaj korak.
Molimo provjerite jeste li unijeli ispravan ID zadatka i pokušajte ponovno.
Varijable u odgovoru:
Varijabla
title
taskId
created
taskClass
status
initiator
contextID
payload
exceptionId
type
message
context
Format
niz
niz
niz
niz
niz
niz
niz
niz
niz
niz
niz
Opis
Naziv zadatka koji ljudi mogu pročitati. Koristi se iz vrijednosti zahtjeva za stvaranje zadatka.
Interní ID tasku
Datum i vrijeme kada je zadatak kreiran.
Moguće vrijednosti: [TRANSACTION, BATCH, DUMMY]
Moguće vrijednosti: [CREATED, STARTED, INIT_OK, INIT_ERROR, IN_PROGRESS, COMPLETED, CANCELLED, ERROR]
Opis inicijatora na strani klijenta. Koristi se iz vrijednosti zahtjeva.
ID pogođenog ciljnog entiteta, ako postoji (transactionId / batchId)
Pseudo-jedinstveni ID iznimke. Može poslužiti kao "ID podrške" koji korisnik može dati podršci kako bi istražio potencijalni problem.
Vrsta iznimke.
Poruka o iznimci.
Kontekst iznimke - više informacija.
Primjer
Invoice 36744
dFd3sda
2025-12-18T08:21:39.427Z
BATCH
IN_PROGRESS
Cash desk 12
12DFSFSSF
FujIk6
VALIDATION_EXCEPTION
Password too weak
[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
Zahtjev za status zadatka treba ponavljati dok se ne dobije jedan od konačnih kodova odgovora, a to su:
Status
INIT_ERROR
Završeno
OTKAZANO
ERROR
Opis
Proces plaćanja nije mogao biti pokrenut. Molimo provjerite poruku o pogrešci.
Kad dosegnete ovu fazu, vaš je zadatak dovršen i rezultat je dostupan.
Zadatak je otkazao korisnik.
Došlo je do pogreške tijekom obrade zadatka.
Što učiniti
Slijedite upute za pogrešku.
Můžete pokračovat dalším krokem.
Trebali biste započeti novi zadatak jer je korisnik otkazao ovaj zadatak.
Slijedite upute za pogrešku.
Možete prijeći na sljedeći korak samo ako je odgovor u statusu COMPLETED.
Dobivanje završnog rezultata
Sada znamo da je serija autorizirana. Cilj ovog koraka je dobiti status i detalje serije. Za novi zahtjev, pozvat ćete GET krajnju točku /v1/batches/{batchId}, koristeći sljedeće varijable:
Varijabla
batchId
Format
niz
Opis
ID dávky, které získáte v předchozích krocích.
Primjer
12DFSFSSF
Mogući kodovi odgovora su:
Odgovor
RC200
RC404
Poruka
OK - Završne pojedinosti navedene
Za trenutni TID nije pronađeno zatvaranje.
Poruka
Uspješan odgovor na vaš zahtjev za zatvaranje.
Do ovog stanja dolazi kada zadani ID zatvaranja nije pronađen za vaš uređaj.
Opis
Transakcija je dovršena!
Provjerite ID transakcije.
Odgovor sadrži sljedeće varijable ovisno o kodu odgovora:
Varijabla
batchid
communicationId
batchNumber
date
previousBatchDate
firstTransactionDate
ukupniIznos
currency
totalCount
saleCount
saleAmount
voidCount
voidAmount
invalidCount
amsBatchNumber
subBatches
Format
niz
niz
niz
niz
niz
niz
number
niz
number
number
number
number
number
number
niz
object
Opis
Interni ID serije, OTVORENO za pseudo seriju s otvorenim transakcijama.
Može se koristiti za tehničku podršku. Pseudo jedinstveni ID za potrebe evidentiranja.
Broj serije za zadani TID.
Točan datum i vrijeme kada je serija zatvorena.
Datum i vrijeme zatvaranja serije. Imate vremensko razdoblje za ovu seriju (OD: prethodna vrijednostDatumaSerije DO: datum valute).
Datum najstarije transakcije.
Total amount for all types of transactions.
Valuta zatvaranja
Ukupan broj transakcija u seriji
Broj transakcija serije prodaje.
Volumen transakcija serije prodaje.
Broj svih transakcija storniranja u seriji.
Volumen svih transakcija storniranja u seriji.
Broj nevažećih transakcija u seriji
Interni ID serije, OTVORENO za pseudo seriju s otvorenim transakcijama.
Osnovne serije unutar meta serije – podijeljene prema vrsti transakcije i uključuju statističke informacije o podređenim serijama prema vrsti načina plaćanja. Sadrži:
-closeBatchNumber (string) - closeBatchNumber podređene serije
- totalCount (number) - Ukupan broj transakcija u seriji
- saleCount (number) - Broj prodajnih transakcija u seriji
- saleAmount (number) - Volumen prodajnih transakcija u seriji
- voidCount (number) - Broj otkazivanja transakcija
- voidAmount (number) - Volumen otkazivanja transakcija u seriji
-closeBatchNumber (string) - closeBatchNumber podređene serije
- totalCount (number) - Ukupan broj transakcija u seriji
- saleCount (number) - Broj prodajnih transakcija u seriji
- saleAmount (number) - Volumen prodajnih transakcija u seriji
- voidCount (number) - Broj otkazivanja transakcija
- voidAmount (number) - Volumen otkazivanja transakcija u seriji
Primjer
12DFSFSSF
2
2025-12-18T08:21:39.427Z
2025-12-17T12:22:11.427Z