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
long
HR: Iznos transakcije s dva decimalna mjesta.
EN: Transaction amount with two decimal places.
EN: Transaction amount with two decimal places.
1000 (=10CZK/EUR)
ID klijenta
niz
HR: Opcionalna provjera prijavljenog korisnika. Ovdje se provjerava API ključ terminala.
EN: Optional check of the logged in user. Here the terminal API key is checked.
EN: Optional check of the logged in user. Here the terminal API key is checked.
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.
Reference number up to 20 characters - suitable for invoice number, payment - can be used for your matching of payments to sales or orders.
Reference number up to 20 characters - suitable for invoice number, payment - can be used for your matching of payments to sales or orders.
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.
Defines whether the receipt is passed to the client by your application or GP tom. The default value is true (i.e. GP will offer a way to pass the receipt to the client). If you send a value of "false", we return the user to your app immediately after the transaction and it's up to you to pass the receipt.
Defines whether the receipt is passed to the client by your application or GP tom. The default value is true (i.e. GP will offer a way to pass the receipt to the client). If you send a value of "false", we return the user to your app immediately after the transaction and it's up to you to pass the receipt.
istina/laž
iznos
long
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.
EN: In restaurants, you can ask the customer to add a tip, where the tip is entered in your system. This amount is then added to the original amount entered by the merchant.
EN: In restaurants, you can ask the customer to add a tip, where the tip is entered in your system. This amount is then added to the original amount entered by the merchant.
1000 (=10CZK/EUR)
redirectUrl
niz
HR: URL vaše aplikacije na koju ćemo preusmjeriti klijenta nakon dovršetka plaćanja.
EN: The URL of your application to which we will redirect the client after completing the payment.
EN: The URL of your application to which we will redirect the client after completing the payment.
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.
EN: An optional field that brings up the tip entry screen in the GP tom application. After entering the tip in the application, a screen for attaching the card will be displayed. You also need to have tipping enabled in the app to bring up this screen.
EN: An optional field that brings up the tip entry screen in the GP tom application. After entering the tip in the application, a screen for attaching the card will be displayed. You also need to have tipping enabled in the app to bring up this screen.
true / false
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: In the case of sending a receipt from the GP tom application, it is possible to predefine the method of sending the receipt via the API. Possible values are:
PHONE
EMAIL
QR
PRINT
EN: In the case of sending a receipt from the GP tom application, it is possible to predefine the method of sending the receipt via the API. Possible values are:
PHONE
QR
sms poruka
telefon klijenta
niz
HR: Telefonski broj klijenta.
EN: Client phone number.
EN: Client phone number.
+420606505404
email klijenta
niz
HR: Adresa e-pošte klijenta.
EN: Client email address.
EN: Client email address.
info@gptom.com
vrsta transakcije
niz
HR: Vrsta transakcije definira vrstu transakcije koju želite pokrenuti. Dostupne vrijednosti su:
EN:Transaction Type defines the type of transaction you want to initiate. Available values are:
GOTOVINA
KARTA
PLAĆANJE_RAČUNA
BLIK_PLATNJA
PLAĆANJE_VRATA
EN:Transaction Type defines the type of transaction you want to initiate. Available values are:
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: Gives information in which state has your request ended.
EN: Gives information in which state has your request ended.
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: Defines batch number. Present during the close batch transaction.
EN: Defines batch number. Present during the close batch transaction.
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: Unique transaction number.
EN: Unique transaction number.
emvAid
HR: Identificira EMV aplikaciju koja se koristi za obradu transakcije.
EN: Identifies the EMV app used for transaction processing.
EN: Identifies the EMV app used for transaction processing.
A0000000031010
broj referencije
HR: Broj referencije naveden pri zahtjevu za plaćanje.
EN: Reference number entered during the payment
EN: Reference number entered during the payment
ABC123
broj sekvence
HR: Koristi se za otkazivanje transakcija. Koristite vrijednost primljenu kao dio transakcije koju želite otkazati.
EN: Used for transaction cancellation. Used the received value which was a part of transaction you want to cancel.
EN: Used for transaction cancellation. Used the received value which was a part of transaction you want to cancel.
001000000
cardType
HR: Identificira vrstu korištene kartice.
EN: Identifies used card type.
EN: Identifies used card type.
VISA
MASTER
MASTER
vrsta transakcije
HR: Definira vrstu transakcije.
EN: Defines type of transaction.
EN: Defines type of transaction.
KARTA
date
HR: Označava vrijeme transakcije.
EN: Give date of transaction.
EN: Give date of transaction.
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: Tip. Filled in if needed.
EN: Tip. Filled in if needed.
2
ukupniIznos
HR: CZ: Označava ukupan iznos transakcije (uključujući napojnicu)
EN: Indicates the total amount of transaction (including tip)
EN: Indicates the total amount of transaction (including tip)
12
rezultat
HR: Odgovor na zahtjev.
EN: Result to the request.
EN: Result to the request.
0 - approved transaction
-1 - declined transaction
-1 - declined transaction
Način unosa kartice
HR: Identificira način unosa podataka s kartice, kao što su čip, beskontaktno, magnetska traka itd.
EN: Defines how the card was read: magstripe, chip or contactless.
EN: Defines how the card was read: magstripe, chip or contactless.
CONTACTLESS
ID transakcije
HR: Ispunjava se samo ako je transakcija odobrena.
EN: Is present just if the transaction is processed.
EN: Is present just if the transaction is processed.
123456
kod za autorizaciju
HR: Jedinstveni ID koji je generirao aplikacija za plaćanje tijekom procesa registracije transakcije.
EN: Unique ID generated by payment app during the transaction registration process.
EN: Unique ID generated by payment app during the transaction registration process.
001000000
Potvrdi OK
istina/laž
brojkartice
HR: Broj kartice (PAN). Pohranjuje se u šifriranom obliku.
EN: Card Number (PAN). It is present in masked form.
EN: Card Number (PAN). It is present in masked form.
0001
KOD
HR: Prikazuje rezultat transakcije autorizacije.
EN: Shows transaction result on the authorization side.
EN: Shows transaction result on the authorization side.
accepted