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: Jedinstveni amsID koji ćete dobiti nakon uplate.
EN: Jedinstveni amsID koji ćete dobiti nakon uplate.
redirectUrl
niz
HR: URL vaše aplikacije na koju ćemo preusmjeriti kupca nakon što otkazivanje bude dovršeno.
URL vaše aplikacije na koju ćemo preusmjeriti klijenta nakon što otkazivanje bude dovršeno.
URL vaše aplikacije na koju ćemo preusmjeriti klijenta nakon što otkazivanje bude dovršeno.
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: 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
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: Određuje 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 postavite vrijednost na "false", korisnika ćemo odmah nakon transakcije preusmjeriti natrag u vašu aplikaciju, a na vama je da dostavite potvrdu o uplati.
EN: Određuje 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 postavite vrijednost na "false", korisnika ćemo odmah nakon transakcije preusmjeriti natrag u vašu aplikaciju, a na vama je da dostavite potvrdu o uplati.
istina/laž
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
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: 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.
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 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: Prikazuje 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 = 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: 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: 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
kod za autorizaciju
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
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
Potvrdi OK
istina/laž
dccPodaci:
stanje
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: Označava status DCC-a. Ako je "ACCEPTED", transakcija je obrađena putem DCC-a i morate unijeti detalje DCC-a na računu. Ako je "NOT_ACCEPTED", detalje DCC-a možete zanemariti.
EN: Označava status DCC-a. Ako je "ACCEPTED", transakcija je obrađena putem DCC-a i morate unijeti detalje DCC-a na računu. Ako je "NOT_ACCEPTED", detalje DCC-a možete zanemariti.
Prihvaćeno
NIJE PRIHVATLJIVO
NIJE PRIHVATLJIVO
KOD
HR: Prikazuje rezultat transakcije autorizacije.
EN: Prikazuje rezultat transakcije na strani autorizacije.
EN: Prikazuje rezultat transakcije na strani autorizacije.
odobreno