Transakcija povrata omogućuje vam povrat novca na bilo koju karticu kupca bez potrebe za praćenjem prethodne prodajne transakcije.
Postupak povrata je sljedeći:
Stvaranje povrata
Transakciju je moguće pokrenuti pozivom:
gptom://transaction/refund?…
gdje se sljedeći parametri koriste za izgradnju poruke, uključujući amsID koji se dodjeljuje za svako plaćanje:
Varijabla/Polje
Format
Opis
Primjer
amount
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: Jedinstveni ID tvrtke, koji ćete dobiti u prijavi ili u e-poruci dobrodošlice.
EN: The unique ID of the company that you will receive in the application or welcome email.
EN: The unique ID of the company that you will receive in the application or welcome email.
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
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.
EN: Reference number up to 20 characters - suitable for invoice number, payment - can be used for your matching of payments to sales or orders.
EN: Reference number up to 20 characters - suitable for invoice number, payment - can be used for your matching of payments to sales or orders.
abc123
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
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
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/refund?amount=1000&preferableReceiptType=QR&clientPhone=+420606505404&clientID=123&printByPaymentApp=true&redirectUrl=gp://transaction/refund&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
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
cardType
HR: Identificira vrstu korištene kartice.
EN: Identifies used card type.
EN: Identifies used card type.
VISA
MASTER
MASTER