Transakce návrat umožňuje vrátit peníze na jakoukoliv kartu zákazníka bez potřeby dohledání předešlé prodejní transakce.
Průběh návratu je následující:
Vytvoření návratu
Transakci lze iniciovat zavoláním:
gptom://transaction/refund?…
kde jsou použity následující parametry pro sestavení zprávy včetně amsID, které je přiděleno pro každou platbu:
Proměnná/Field
Formát/Format
Popis/Description
Příklad
Betrag
long
CZ: Částka transakce s dvěma desetinnými místy.
1000 (=10CZK/EUR)
clientID
string
EN: Transaction amount with two decimal places.
redirectUrl
string
CZ: Unikátní amsID, které dostanete při platbě.
fb://Success
originReferenceNum
string
EN: The unique amsID that you will receive upon payment.
abc123
preferableReceiptType
enum (sms,email,qr,print)
CZ: URL vaší aplikace na kterou přesměrujeme klienta po dokončení storna.
sms
printByPaymentApp
bool
EN: The URL of your application to which we will redirect the client after the cancellation is complete.
wahr/falsch
clientPhone
string
CZ: Referenční číslo až 20 znaků - vhodné pro číslo faktury, platby - je možné použít pro vaše párování platby k prodejům či objednávkám.
+420606505404
clientEmail
string
EN: Reference number up to 20 characters - suitable for invoice number, payment - can be used for your matching of payments to sales or orders.
info@gptom.com
CZ: V případě odeslání účtenky z aplikace GP tom je možné přes API předdefinovat způsob odeslání účtnky. Možné hodnoty jsou:
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:
TELEFON
EMAIL
QR
DRUCKEN
CZ: Definuje, zda účtenku klientovi předá vaše aplikace nebo GP tom. Výchozí hodnota je true (tedy GP tom nabídne způsob předání účtenky klientovi). Pokud pošlete hodnotu “false”, ihned po transakci vrátíme uživatele do vaší aplikace a předání účtenky je na vás.
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.
CZ: Telefonní číslo klienta.
EN: Client phone number.
CZ: Emailová adresa klienta.
EN: Client email address.
Příklad volání:
gptom://transaction/refund?amount=1000&preferableReceiptType=QR&clientPhone=+420606505404&clientID=123&printByPaymentApp=true&redirectUrl=gp://transaction/refund&clientEmail=info@gptom.com
Odpověď bude obsahovat následující pole:
Pole/Field
Popis/Decription
Příklad/Example
TASK STATUS
CZ: Dává odpověď v jakém stavu skončil daný požadavek.
ABGESCHLOSSEN
terminalID
EN: Gives information in which state has your request ended.
CANCELED
Betrag
CZ: ID des Terminals, an dem die Transaktionen verarbeitet werden. Identifiziert das Terminal in GP-Systemen.
ERROR
batchNumber
DE: Eindeutige Terminal-ID, mit der die Transaktion verarbeitet wird.
12345678
emvAppLabel
CZ: Der Betrag bestimmt das Volumen der Transaktion. Dieser Betrag wird in der vom Terminal verwendeten Landeswährung berechnet. Für einen Abschluss umfasst er alle Kartentransaktionen, gutgeschrieben minus belastet.
10
amsID
DE: Der Betrag bestimmt das Volumen der Transaktion. Dieser Betrag wird in der vom Terminal verwendeten Landeswährung berechnet. Zum Tagesabschluss enthält er alle Kartentransaktionen, Gutschriften abzüglich Belastungen.
1
referenzNummer
CZ: Kennzeichnet die Abschlussnummer. Anzugeben, wenn eine Frist beantragt wird.
Visa Debit
sequenceNumber
DE: Definiert die Chargennummer. Wird bei der Transaktion "Charge abschließen" angezeigt.
transactionType
CZ: Der Name des EMV, der bei der Zahlung verwendet wurde.
ABC123
Datum
EN: Card label of used card
001000000
currencyCode
CZ: Unikátní číslo transakce.
KARTE
merchantID
EN: Unique transaction number.
2024-10-29T12:14:00.112Z
TipAmount
CZ: Bei der Zahlungsanforderung angegebene Referenznummer.
EUR
totalAmount
EN: Reference number entered during the payment
Ergebnis
CZ: Wird für Stornotransaktionen verwendet. Verwenden Sie den empfangenen Wert, der Teil der Transaktion war, die Sie stornieren möchten.
2
cardEntryMode
DE: Wird für die Stornierung von Transaktionen verwendet. Verwendet den empfangenen Wert, der Teil der Transaktion war, die Sie stornieren möchten.
12
transaktionsID
CZ: Definuje typ transakce.
0 = completed
authorizationCode
EN: Defines type of transaction.
-1 = declined
cardNumber
CZ: Udává čas transakce.
CONTACTLESS
pinOk
EN: Give date of transaction.
001000000
CODE
CZ: Dreistellige ISO-Währungscodes - siehe die Wiki-Seite für eine Liste.
123456
emvAid
DE: Dreistelliger ISO-Code der Währung.
0001
cardType
CZ: Eindeutige Händlerkennung, die in der Regel eine Standortkennung darstellt.
wahr/falsch
DE: Eindeutige Händler-ID, normalerweise Standort-ID
approved
CZ: Tipps. Wird ausgefüllt, wenn es eingegeben wurde.
A0000000031010
DE: Tipp. Bei Bedarf auszufüllen.
VISA
CZ: Udává celkovou čásku transakce (včetně spropitného).
MASTER
EN: Indicates the total amount of transaction (including tip)
CZ: Odpověď na požadavek.
EN: Result to the request.
CZ: Identifikuje způsob zadávání údajů o kartě, jako je čip, bezkontaktní, Magstripe atd.
EN: Defines how the card was read: magstripe, chip or contactless.
CZ: Eindeutige ID, die von der Zahlungsanwendung während der Registrierung der Transaktion generiert wird.
EN: Unique ID generated by payment app during the transaction registration process.
CZ: Nur auszufüllen, wenn die Transaktion schließlich genehmigt wird.
DE: Ist nur vorhanden, wenn die Transaktion bearbeitet wird.
CZ: Číslo karty (PAN). Je přítomen v maskované formě.
EN: Card Number (PAN). It is present in masked form.
CZ: Zobrazuje výsledek transakce na autorizaci.
EN: Shows transaction result on the authorization side.
CZ: Identifikuje aplikaci EMV používanou pro zpracování transakce.
EN: Identifies the EMV app used for transaction processing.
CZ: Identifikuje použitý typ karty.
EN: Identifies used card type.