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
Die Transaktion kann durch einen Anruf eingeleitet werden:
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:
Variable/Feld
Format/Format
Beschreibung/Beschreibung
Beispiel
Betrag
long
CZ: Částka transakce s dvěma desetinnými místy.
EN: Transaction amount with two decimal places.
EN: Transaction amount with two decimal places.
1000 (=10CZK/EUR)
clientID
String
CZ: Unikátní ID společnosti, které získáte v aplikaci nebo ve welcome emailu.
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
String
CZ: URL Ihrer Anwendung, an die wir den Kunden nach Abschluss der Stornierung weiterleiten.
DE: Die URL Ihrer Anwendung, an die wir den Kunden nach Abschluss der Stornierung weiterleiten werden.
DE: Die URL Ihrer Anwendung, an die wir den Kunden nach Abschluss der Stornierung weiterleiten werden.
fb://Success
originReferenceNum
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.
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
preferableReceiptType
enum (sms,email,qr,print)
CZ: Für den Versand einer Quittung aus der GP tom-Anwendung kann die Methode für den Versand der Quittung über die API vordefiniert werden. Mögliche Werte sind:
DE: Für den Versand einer Quittung aus der GP tom-Anwendung kann die Methode für den Versand der Quittung über die API vordefiniert werden. Mögliche Werte sind:
TELEFON
EMAIL
DRUCKEN
DE: Für den Versand einer Quittung aus der GP tom-Anwendung kann die Methode für den Versand der Quittung über die API vordefiniert werden. Mögliche Werte sind:
TELEFON
Text
printByPaymentApp
bool
CZ: Legt fest, ob die Quittung von Ihrer Anwendung oder von GP tom an den Client weitergegeben wird. Der Standardwert ist “true” (d.h. GP tom bietet die Methode zur Weitergabe der Quittung an den Kunden an). Wenn Sie den Wert "false" angeben, geben wir den Benutzer unmittelbar nach der Transaktion an Ihre Anwendung zurück und es liegt an Ihnen, die Quittung zu übergeben.
DE: Legt fest, ob die Quittung von Ihrer Anwendung oder von GP tom an den Client weitergegeben wird. Der Standardwert ist "true" (d. h. GP bietet eine Möglichkeit, die Quittung an den Client weiterzugeben). Wenn Sie den Wert "false" senden, wird der Benutzer unmittelbar nach der Transaktion an Ihre Anwendung zurückgegeben und es liegt an Ihnen, die Quittung weiterzugeben.
DE: Legt fest, ob die Quittung von Ihrer Anwendung oder von GP tom an den Client weitergegeben wird. Der Standardwert ist "true" (d. h. GP bietet eine Möglichkeit, die Quittung an den Client weiterzugeben). Wenn Sie den Wert "false" senden, wird der Benutzer unmittelbar nach der Transaktion an Ihre Anwendung zurückgegeben und es liegt an Ihnen, die Quittung weiterzugeben.
wahr/falsch
KundeTelefon
String
CZ: Telefonnummer des Kunden.
DE: Rufnummer des Kunden.
DE: Rufnummer des Kunden.
+420606505404
clientEmail
String
CZ: E-Mail Adresse des Kunden.
DE: E-Mail Adresse des Kunden.
DE: E-Mail Adresse des Kunden.
info@gptom.com
Beispielanruf:
gptom://transaction/refund?amount=1000&preferableReceiptType=QR&clientPhone=+420606505404&clientID=123&printByPaymentApp=true&redirectUrl=gp://transaction/refund&clientEmail=info@gptom.com
Die Antwort wird die folgenden Felder enthalten:
Feld/Feld
Beschreibung/Beschreibung
Beispiel/Beispiel
AUFGABENSTATUS
CZ: Gibt die Antwort, in welchem Zustand die Anfrage beendet wurde.
DE: Gibt Auskunft darüber, in welchem Bundesland Ihr Ersuchen beendet wurde.
DE: Gibt Auskunft darüber, in welchem Bundesland Ihr Ersuchen beendet wurde.
ABGESCHLOSSEN
ANGESAGT
ERROR
ANGESAGT
ERROR
terminalID
CZ: ID des Terminals, an dem die Transaktionen verarbeitet werden. Identifiziert das Terminal in GP-Systemen.
DE: Eindeutige Terminal-ID, mit der die Transaktion verarbeitet wird.
DE: Eindeutige Terminal-ID, mit der die Transaktion verarbeitet wird.
12345678
Betrag
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.
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.
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.
10
batchNumber
CZ: Kennzeichnet die Abschlussnummer. Anzugeben, wenn eine Frist beantragt wird.
DE: Definiert die Chargennummer. Wird bei der Transaktion "Charge abschließen" angezeigt.
DE: Definiert die Chargennummer. Wird bei der Transaktion "Charge abschließen" angezeigt.
1
emvAppLabel
CZ: Der Name des EMV, der bei der Zahlung verwendet wurde.
DE: Kartenetikett der verwendeten Karte
DE: Kartenetikett der verwendeten Karte
Visa-Lastschrift
amsID
CZ: Eindeutige Transaktionsnummer.
DE: Eindeutige Transaktionsnummer.
DE: Eindeutige Transaktionsnummer.
referenzNummer
CZ: Bei der Zahlungsanforderung angegebene Referenznummer.
DE: Bei der Zahlung eingegebene Referenznummer
DE: Bei der Zahlung eingegebene Referenznummer
ABC123
sequenceNumber
CZ: Wird für Stornotransaktionen verwendet. Verwenden Sie den empfangenen Wert, der Teil der Transaktion war, die Sie stornieren möchten.
DE: Wird für die Stornierung von Transaktionen verwendet. Verwendet den empfangenen Wert, der Teil der Transaktion war, die Sie stornieren möchten.
DE: Wird für die Stornierung von Transaktionen verwendet. Verwendet den empfangenen Wert, der Teil der Transaktion war, die Sie stornieren möchten.
001000000
transactionType
DE: Definiert die Transaktionsart.
DE: Definiert die Art der Transaktion.
DE: Definiert die Art der Transaktion.
KARTE
Datum
CZ: Gibt den Zeitpunkt der Transaktion an.
DE: Geben Sie das Datum der Transaktion an.
DE: Geben Sie das Datum der Transaktion an.
2024-10-29T12:14:00.112Z
currencyCode
CZ: Dreistellige ISO-Währungscodes - siehe die Wiki-Seite für eine Liste.
DE: Dreistelliger ISO-Code der Währung.
DE: Dreistelliger ISO-Code der Währung.
EUR
merchantID
CZ: Eindeutige Händlerkennung, die in der Regel eine Standortkennung darstellt.
DE: Eindeutige Händler-ID, normalerweise Standort-ID
DE: Eindeutige Händler-ID, normalerweise Standort-ID
TipAmount
CZ: Tipps. Wird ausgefüllt, wenn es eingegeben wurde.
EN: Tip. Filled in if needed
EN: Tip. Filled in if needed
2
totalAmount
CZ: Zeigt die gesamte Transaktionszeile (einschließlich Trinkgeld) an.
DE: Gibt den Gesamtbetrag der Transaktion an (einschließlich Trinkgeld)
DE: Gibt den Gesamtbetrag der Transaktion an (einschließlich Trinkgeld)
12
Ergebnis
CZ: Antwort auf Anfrage.
DE: Ergebnis der Anfrage.
DE: Ergebnis der Anfrage.
0 = abgeschlossen
-1 = abgelehnt
-1 = abgelehnt
cardEntryMode
CZ: Gibt die Methode zur Eingabe der Kartendaten an, z. B. Chip, kontaktlos, Magstripe usw.
DE: Gibt an, wie die Karte gelesen wurde: Magnetstreifen, Chip oder kontaktlos.
DE: Gibt an, wie die Karte gelesen wurde: Magnetstreifen, Chip oder kontaktlos.
KONTAKTLOS
transaktionsID
CZ: Eindeutige ID, die von der Zahlungsanwendung während der Registrierung der Transaktion generiert wird.
DE: Eindeutige ID, die von der Zahlungs-App während der Transaktionsregistrierung generiert wird.
DE: Eindeutige ID, die von der Zahlungs-App während der Transaktionsregistrierung generiert wird.
001000000
authorizationCode
CZ: Nur auszufüllen, wenn die Transaktion schließlich genehmigt wird.
DE: Ist nur vorhanden, wenn die Transaktion bearbeitet wird.
DE: Ist nur vorhanden, wenn die Transaktion bearbeitet wird.
123456
cardNumber
CZ: Kartennummer (PAN). Sie ist in maskierter Form vorhanden.
DE: Kartennummer (PAN); sie ist in maskierter Form vorhanden.
DE: Kartennummer (PAN); sie ist in maskierter Form vorhanden.
0001
pinOk
wahr/falsch
CODE
CZ: Zeigt das Ergebnis der Transaktion bei der Autorisierung an.
DE: Zeigt das Ergebnis der Transaktion auf der Autorisierungsseite an.
DE: Zeigt das Ergebnis der Transaktion auf der Autorisierungsseite an.
genehmigt
emvAid
CZ: Identifikuje aplikaci EMV používanou pro zpracování transakce.
EN: Identifies the EMV app used for transaction processing.
EN: Identifies the EMV app used for transaction processing.
A0000000031010
cardType
CZ: Identifikuje použitý typ karty.
EN: Identifies used card type.
EN: Identifies used card type.
VISA
MASTER
MASTER