Prodajna transakcija je osnovna platna operacija koja osigurava prijenos određenog iznosa s bankovnog računa korisnika kartice na račun trgovca.
Što se tiče postupka plaćanja, postupak je sljedeći:
Stvaranje transakcije
Transakciju je moguće pokrenuti pozivom:
gptom://transaction/create?…
gdje se za izgradnju poruke koriste sljedeći parametri:
Varijabla/Polje
Format
Opis
Primjer
amount
OBAVEZNO
OBAVEZNO
dug
HR: Iznos transakcije s dva decimalna mjesta.
EN: Iznos transakcije s dva decimalna mjesta.
EN: Iznos transakcije s dva decimalna mjesta.
1.000 (= 10 CZK/EUR)
ID klijenta
niz
HR: Opcionalna provjera prijavljenog korisnika. Ovdje se provjerava API ključ terminala.
EN: Opcionalna provjera prijavljenog korisnika. To uključuje provjeru terminalnog API ključa.
EN: Opcionalna provjera prijavljenog korisnika. To uključuje provjeru terminalnog API ključa.
broj izvora
niz
HR: Referentni broj do 20 znakova - pogodan za brojeve računa, plaćanja - može se koristiti za povezivanje vaših plaćanja s prodajom ili narudžbama.
Referentni broj (do 20 znakova) – pogodan za brojeve računa ili plaćanja – može se koristiti za povezivanje plaćanja s prodajom ili narudžbama.
Referentni broj (do 20 znakova) – pogodan za brojeve računa ili plaćanja – može se koristiti za povezivanje plaćanja s prodajom ili narudžbama.
isprintaj po uplati
logička vrijednost
HR: Ovo određuje hoće li vaša aplikacija ili GP tom isporučiti račun kupcu. Zadana vrijednost je true (što znači da će GP tom ponuditi isporuku računa kupcu). Ako vrijednost postavite na false, korisnika ćemo vratiti u vašu aplikaciju odmah nakon transakcije, a na vama je da isporučite račun.
Definira hoće li se potvrda proslijediti klijentu putem vaše aplikacije ili putem GP-a. Zadana vrijednost je true (tj. GP će osigurati način za prosljeđivanje potvrde klijentu). Ako ovo postavite na "false", korisnika ćemo vratiti u vašu aplikaciju odmah nakon transakcije, a na vama je da proslijedite potvrdu.
Definira hoće li se potvrda proslijediti klijentu putem vaše aplikacije ili putem GP-a. Zadana vrijednost je true (tj. GP će osigurati način za prosljeđivanje potvrde klijentu). Ako ovo postavite na "false", korisnika ćemo vratiti u vašu aplikaciju odmah nakon transakcije, a na vama je da proslijedite potvrdu.
istina/laž
iznos
dug
HR: U restoranima možete zamoliti kupca da doda napojnicu, a napojnica se unosi iz vašeg sustava. Taj se iznos zatim dodaje izvornom iznosu koji je unio trgovac.
U restoranima možete zatražiti od kupca da doda napojnicu, koja se zatim unosi u vaš sustav. Taj se iznos potom zbraja s iznosom koji je trgovac izvorno unio.
U restoranima možete zatražiti od kupca da doda napojnicu, koja se zatim unosi u vaš sustav. Taj se iznos potom zbraja s iznosom koji je trgovac izvorno unio.
1.000 (= 10 CZK/EUR)
redirectUrl
niz
HR: URL vaše aplikacije na koju ćemo preusmjeriti klijenta nakon dovršetka plaćanja.
URL vaše aplikacije na koju ćemo preusmjeriti klijenta nakon dovršetka uplate.
URL vaše aplikacije na koju ćemo preusmjeriti klijenta nakon dovršetka uplate.
fb://success
savjetPrikupi
logička vrijednost
HR: Neobavezno polje koje otvara zaslon za unos napojnice u aplikaciji GP tom. Nakon unosa napojnice u aplikaciju, pojavit će se zaslon za prilaganje kartice. Da biste otvorili ovaj zaslon, morate omogućiti i napojnicu u aplikaciji.
Opcionalno polje koje otvara zaslon za unos napojnice u GP tom aplikaciji. Nakon što unesete napojnicu u aplikaciju, pojavit će se zaslon za priloženje kartice. Također morate imati omogućenu opciju napojnica u aplikaciji da bi se ovaj zaslon pojavio.
Opcionalno polje koje otvara zaslon za unos napojnice u GP tom aplikaciji. Nakon što unesete napojnicu u aplikaciju, pojavit će se zaslon za priloženje kartice. Također morate imati omogućenu opciju napojnica u aplikaciji da bi se ovaj zaslon pojavio.
istina / laž
poželjeni tip potvrde o uplati
enum (sms, e-pošta, qr, ispis)
HR: Prilikom slanja računa iz GP tom aplikacije, moguće je unaprijed definirati način slanja računa putem API-ja. Moguće vrijednosti su:
EN: Prilikom slanja potvrde iz GP-a u aplikaciju moguće je unaprijed definirati metodu slanja potvrde putem API-ja. Moguće vrijednosti su:
TELEFON
E-pošta
QR
Isprintaj
EN: Prilikom slanja potvrde iz GP-a u aplikaciju moguće je unaprijed definirati metodu slanja potvrde putem API-ja. Moguće vrijednosti su:
TELEFON
E-pošta
QR
Isprintaj
sms poruka
telefon klijenta
niz
HR: Telefonski broj klijenta.
EN: Telefonski broj klijenta.
EN: Telefonski broj klijenta.
+420606505404
email klijenta
niz
HR: Adresa e-pošte klijenta.
EN: Adresa e-pošte klijenta.
EN: Adresa e-pošte klijenta.
info@gptom.com
vrsta transakcije
niz
HR: Vrsta transakcije definira vrstu transakcije koju želite pokrenuti. Dostupne vrijednosti su:
Tip transakcije definira vrstu transakcije koju želite pokrenuti. Dostupne vrijednosti su:
GOTOVINA
KARTA
PLAĆANJE_RAČUNA
BLIK_PLATNJA
PLAĆANJE_VRATA
Tip transakcije definira vrstu transakcije koju želite pokrenuti. Dostupne vrijednosti su:
GOTOVINA
KARTA
PLAĆANJE_RAČUNA
BLIK_PLATNJA
PLAĆANJE_VRATA
KARTA
Primjer poziva:
gptom://transaction/create?originReferenceNum=12345&amount=2&clientID=123&tipCollect=true&preferableReceiptType=QR&redirectUrl=gp://transaction/create&printByPaymentApp=true&clientPhone=+420606505404&clientEmail=info@gptom.com&tipAmount=1
Odgovor će sadržavati sljedeća polja:
Polje/Field
Format
Opis
Primjer/Example
TASK STATUS
HR: Daje odgovor u kojem je stanju zadani zahtjev završio.
EN: Pruža informacije o statusu vašeg zahtjeva.
EN: Pruža informacije o statusu vašeg zahtjeva.
Završeno
CANCELLED
ERROR
CANCELLED
ERROR
identifikacijski broj terminala
HR: ID terminala na kojem se obrađuju transakcije. Identificira terminal unutar GP sustava.
EN: Unique terminal ID, on which the transaction is processed.
EN: Unique terminal ID, on which the transaction is processed.
12345678
amount
HR: Iznos određuje obujam transakcije. Ovaj se iznos izračunava u lokalnoj valuti koju terminal koristi. Na kraju dana uključuje sve kartične transakcije, pri čemu se krediti oduzimaju od debitnih transakcija.
EN: The amount determines the volume of the transaction. This amount is calculated in the domestic currency used by the terminal. At close day, it contains all card transactions, credited minus debit.
EN: The amount determines the volume of the transaction. This amount is calculated in the domestic currency used by the terminal. At close day, it contains all card transactions, credited minus debit.
10
batchNumber
HR: Identificira broj zatvaranja. Ispuniti pri zahtjevu za zatvaranje.
EN: Definira broj serije. Pojavljuje se tijekom transakcije zatvaranja serije.
EN: Definira broj serije. Pojavljuje se tijekom transakcije zatvaranja serije.
1
emvAppLabel
HR: Naziv EMV-a koji je korišten za plaćanje.
Oznaka za iskorištenu karticu
Oznaka za iskorištenu karticu
Debitna kartica
amsID
HR: Jedinstveni broj transakcije.
EN: Jedinstveni broj transakcije.
EN: Jedinstveni broj transakcije.
emvAid
HR: Identificira EMV aplikaciju koja se koristi za obradu transakcije.
EN: Identificira EMV aplikaciju koja se koristi za obradu transakcija.
EN: Identificira EMV aplikaciju koja se koristi za obradu transakcija.
A0000000031010
broj referencije
HR: Broj referencije naveden pri zahtjevu za plaćanje.
EN: Referentni broj unesen tijekom plaćanja
EN: Referentni broj unesen tijekom plaćanja
ABC123
broj sekvence
HR: Koristi se za otkazivanje transakcija. Koristite vrijednost primljenu kao dio transakcije koju želite otkazati.
EN: Koristi se za otkazivanje transakcije. Upotrijebite vrijednost primljenu kao dio transakcije koju želite otkazati.
EN: Koristi se za otkazivanje transakcije. Upotrijebite vrijednost primljenu kao dio transakcije koju želite otkazati.
001000000
vrsta kartice
HR: Identificira vrstu korištene kartice.
EN: Identificira vrstu korištene kartice.
EN: Identificira vrstu korištene kartice.
VISA
MAGISTER
MAGISTER
vrsta transakcije
HR: Definira vrstu transakcije.
EN: Definira vrstu transakcije.
EN: Definira vrstu transakcije.
KARTA
date
HR: Označava vrijeme transakcije.
UN: Unesite datum transakcije.
UN: Unesite datum transakcije.
29. listopada 2024. 12:14:00.112Z
kôd valute
HR: Troznamenkasti ISO kodovi valuta – popis možete pronaći na stranici Wiki.
EN: Three chars currency ISO code.
EN: Three chars currency ISO code.
EUR
ID trgovca
HR: Jedinstveni ID trgovca, koji je obično ID lokacije.
EN: Unique merchant ID, usually location ID
EN: Unique merchant ID, usually location ID
iznos
HR: Napojnica. Popunjeno ako je unesena napojnica.
EN: Savjet. Ispunite ako je potrebno.
EN: Savjet. Ispunite ako je potrebno.
2
ukupniIznos
HR: CZ: Označava ukupan iznos transakcije (uključujući napojnicu)
EN: Označava ukupan iznos transakcije (uključujući napojnicu)
EN: Označava ukupan iznos transakcije (uključujući napojnicu)
12
rezultat
HR: Odgovor na zahtjev.
EN: Rezultat zahtjeva.
EN: Rezultat zahtjeva.
0 – odobrena transakcija
-1 - transakcija odbijena
-1 - transakcija odbijena
Način unosa kartice
HR: Identificira način unosa podataka s kartice, kao što su čip, beskontaktno, magnetska traka itd.
EN: Navodi se kako je kartica očitana: magnetska traka, čip ili beskontaktno.
EN: Navodi se kako je kartica očitana: magnetska traka, čip ili beskontaktno.
CONTACTLESS
ID transakcije
HR: Ispunjava se samo ako je transakcija odobrena.
EN: Prisutan je samo ako je transakcija obrađena.
EN: Prisutan je samo ako je transakcija obrađena.
123456
kod za autorizaciju
HR: Jedinstveni ID koji je generirao aplikacija za plaćanje tijekom procesa registracije transakcije.
EN: Jedinstveni ID koji je generirao aplikacija za plaćanje tijekom procesa registracije transakcije.
EN: Jedinstveni ID koji je generirao aplikacija za plaćanje tijekom procesa registracije transakcije.
001000000
Potvrdi OK
istina/laž
brojkartice
HR: Broj kartice (PAN). Pohranjuje se u šifriranom obliku.
EN: Broj kartice (PAN). Prikazuje se u maskiranom obliku.
EN: Broj kartice (PAN). Prikazuje se u maskiranom obliku.
0001
dccData:
status
HR: Označava DCC status. Ako je "ACCEPTED", transakcija je izvršena putem DCC-a i morate ispuniti potvrdu s DCC podacima. Ako je "NOT_ACCEPTED", tada možete zanemariti DCC podatke.
EN: Indicates the DCC status. If "ACCEPTED", the transaction was made via DCC and you must fill in the receipt with DCC data. If "NOT_ACCEPTED", then you can ignore the DCC data.
EN: Indicates the DCC status. If "ACCEPTED", the transaction was made via DCC and you must fill in the receipt with DCC data. If "NOT_ACCEPTED", then you can ignore the DCC data.
ACCEPTED
NOT_ACCEPTED
NOT_ACCEPTED
currency
HR: Valuta kartice kupca.
EN: Currency of the customer's card.
EN: Currency of the customer's card.
CZK
amount
HR: Iznos transakcije u DCC valuti - u valuti kupčeve kartice. Mora biti prikazan točno onako kako dolazi u API odgovoru, uključujući broj decimalnih mjesta.
EN: Transaction amount in DCC currency - in the currency of the customer's card. You must present it on your receipt exactly as received through API response including correct decimal numbers.
EN: Transaction amount in DCC currency - in the currency of the customer's card. You must present it on your receipt exactly as received through API response including correct decimal numbers.
61.02
markup
HR: Doplata za tečaj konverzije. Mora biti prikazan točno onako kako dolazi u API odgovoru, uključujući broj decimalnih mjesta.
EN: Markup for the conversion rate. You must present it on your receipt exactly as received through API response including correct decimal numbers.
EN: Markup for the conversion rate. You must present it on your receipt exactly as received through API response including correct decimal numbers.
9.9
exchangeRate
HR: Označava tečaj. Ova vrijednost je u lokalnoj valuti terminala. Mora se prikazati točno onako kako dolazi u API odgovoru, uključujući broj decimalnih mjesta.
EN: Indicates the exchange rate. This value is in the local terminal currency. You must present it on your receipt exactly as received through API response including correct decimal numbers.
EN: Indicates the exchange rate. This value is in the local terminal currency. You must present it on your receipt exactly as received through API response including correct decimal numbers.
24.567
regionSchemaIndicator
HR: Označava je li kartica kupca izdana unutar EU ili izvan nje. Ako je vrijednost "0" ili "1", na računu se mora prikazati tekst "Markup". Ako je vrijednost "2", na računu se mora prikazati tekst "Markup preko ECB tečaja".
EN: Indicates whether the customer's card was issued within the EU or outside. If the value is "0" or "1", the text "Markup" needs to be displayed on the receipt. If the value is "2", the text "Markup over ECB rate" needs to be displayed on the receipt.
EN: Indicates whether the customer's card was issued within the EU or outside. If the value is "0" or "1", the text "Markup" needs to be displayed on the receipt. If the value is "2", the text "Markup over ECB rate" needs to be displayed on the receipt.
0
1
2
1
2
KOD
HR: Prikazuje rezultat transakcije autorizacije.
EN: Prikazuje rezultat transakcije na strani autorizacije.
EN: Prikazuje rezultat transakcije na strani autorizacije.
prihvaćeno