Transakcija povrata je osnovna platna operacija kojom se poništava već obrađena platna transakcija, pri čemu se iznos vraća na račun vlasnika kartice.
Postupak otkazivanja je sljedeći:
Izrada otkazivanja
Transakciju je moguće pokrenuti pozivom:
gptom://transaction/cancel?…
gdje se za generiranje izvješća koriste sljedeći parametri, uključujući amsID, koji se dodjeljuje svakoj uplati:
Varijabla/Polje
Format
Opis
Primjer
ID klijenta
niz
amsID
OBAVEZNO
OBAVEZNO
niz
HR: Jedinstveni amsID koji primate nakon uplate.
EN: The unique amsID that you will receive upon payment.
EN: The unique amsID that you will receive upon payment.
redirectUrl
niz
HR: URL vaše aplikacije na koju ćemo preusmjeriti kupca nakon što otkazivanje bude dovršeno.
EN: The URL of your application to which we will redirect the client after the cancellation is complete.
EN: The URL of your application to which we will redirect the client after the cancellation is complete.
fb://Success
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
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.
EN: 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.
EN: 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ž
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
Primjer poziva:
gptom://transaction/cancel?amsID=123&preferableReceiptType=QR&clientPhone=+420606505404&clientID=123&printByPaymentApp=true&redirectUrl=gp://transaction/cancel&clientEmail=info@gptom.com
Odgovor će sadržavati sljedeća polja:
Polje/Field
Opis/Description
Primjer/Example
TASK STATUS
HR: Pruža informacije o statusu vašeg zahtjeva.
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.
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
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: Prikazuje 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 = dovršeno
-1 = odbijeno
-1 = odbijeno
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: 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
kod za autorizaciju
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
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
Potvrdi OK
istina/laž
KOD
HR: Prikazuje rezultat transakcije autorizacije.
EN: Shows transaction result on the authorization side.
EN: Shows transaction result on the authorization side.
odobreno