Die Stornotransaktion ist eine der grundlegenden Zahlungstransaktionen, die die Stornierung der bereits durchgeführten Zahlungstransaktion auf dem Konto des Karteninhabers gewährleistet.
Das Stornierungsverfahren läuft wie folgt ab:
Erstellen einer Stornierung
Die Transaktion kann durch einen Anruf eingeleitet werden:
gptom://transaction/cancel?…
wobei die folgenden Parameter zur Erstellung des Berichts verwendet werden, einschließlich der amsID, die jeder Zahlung zugewiesen wird:
Variable/Feld
Format/Format
Beschreibung/Beschreibung
Beispiel
clientID
string
amsID MANDATISCH
string
CZ: Eindeutige amsID, die Sie zum Zeitpunkt der Zahlung erhalten.
DE: Die eindeutige amsID, die Sie bei der Zahlung erhalten.
DE: Die eindeutige amsID, die Sie bei der Zahlung erhalten.
redirectUrl
string
CZ: URL Ihrer Anwendung, zu der wir den Kunden nach Abschluss der Stornierung umleiten.
DE: Die URL Ihrer Anwendung, zu der wir den Kunden nach Abschluss der Stornierung umleiten.
DE: Die URL Ihrer Anwendung, zu der wir den Kunden nach Abschluss der Stornierung umleiten.
fb://Success
preferableReceiptType
E-Mailenum (sms, , qr,print)
CZ: Wenn Sie eine Quittung aus der App senden GP tom API Anwendung versenden, kann die Methode für den Versand der Quittung über vordefiniert werden.
Mögliche Werte sind: DE: Beim Versenden einer Quittung aus derGP tom API
E-Mail
Anwendung ist es möglich, die Methode für den Versand der Quittung über die vorzugeben. Mögliche Werte sind: PHONE QR PRINT
Mögliche Werte sind: DE: Beim Versenden einer Quittung aus derGP tom API
Anwendung ist es möglich, die Methode für den Versand der Quittung über die vorzugeben. Mögliche Werte sind: PHONE QR PRINT
Text
printByPaymentApp
bool
CZ: Legt fest, ob die Quittung von Ihrer Anwendung an den Client weitergegeben wird oder GP tom. Der Standardwert ist true (d.h. GP tom bietet eine Möglichkeit, die Quittung an den Kunden weiterzugeben). Wenn Sie den Wert "false" angeben, wird der Benutzer unmittelbar nach der Transaktion an Ihre Anwendung zurückgegeben, und es liegt an Ihnen, die Quittung zu übergeben.
DE: Legt fest, ob die Quittung von Ihrer Anwendung an den Kunden weitergegeben wird oder GP tom. GP Der Standardwert ist true (d.h. es wird eine Möglichkeit angeboten, die Quittung an den Kunden weiterzugeben). Wenn Sie den Wert "false" senden, wird der Benutzer nach der Transaktion sofort zu Ihrer Anwendung zurückgebracht und es liegt an Ihnen, die Quittung zu übergeben.
DE: Legt fest, ob die Quittung von Ihrer Anwendung an den Kunden weitergegeben wird oder GP tom. GP Der Standardwert ist true (d.h. es wird eine Möglichkeit angeboten, die Quittung an den Kunden weiterzugeben). Wenn Sie den Wert "false" senden, wird der Benutzer nach der Transaktion sofort zu Ihrer Anwendung zurückgebracht und es liegt an Ihnen, die Quittung zu übergeben.
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.
E-Mail DE: Adresse des Kunden.
E-Mail DE: Adresse des Kunden.
info@gptom.com
Beispielanruf:
gptom://transaction/cancel?amsID=123&preferableReceiptType=QR&clientPhone=+420606505404&clientID=123&printByPaymentApp=true&redirectUrl=gp://transaction/cancel&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 Zustand Ihre Anfrage beendet wurde.
DE: Gibt Auskunft darüber, in welchem Zustand Ihre Anfrage beendet wurde.
ABGESCHLOSSEN STORNIERT FEHLER
terminalID
CZ: ID des Terminals, an dem die Transaktionen verarbeitet werden. GP
Identifiziert das Terminal in den Systemen. DE: Eindeutige Terminal-ID, an dem die Transaktion verarbeitet wird.
Identifiziert das Terminal in den Systemen. DE: Eindeutige Terminal-ID, an dem die Transaktion verarbeitet wird.
12345678
amount
CZ: Der Betrag bestimmt das Volumen der Transaktion. Dieser Betrag wird in der vom Terminal verwendeten Landeswährung berechnet. Bei einem 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. Am Abschlusstag enthält 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. Am Abschlusstag enthält er alle Kartentransaktionen, gutgeschrieben minus belastet.
10
batchNumber
CZ: Kennzeichnet die Abschlussnummer. Muss ausgefüllt werden, wenn eine Frist beantragt wird.
EN: Definiert die Chargennummer. Wird bei der Transaktion für den Chargenabschluss angegeben.
EN: Definiert die Chargennummer. Wird bei der Transaktion für den Chargenabschluss angegeben.
1
emvAppLabel
CZ: Der Name der EMV-Karte, die für die 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.
referenceNumber
CZ: Bei der Zahlungsanforderung angegebene Referenznummer.
DE: Bei der Zahlungsanforderung eingegebene Referenznummer
DE: Bei der Zahlungsanforderung 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.
CARD
Datum
CZ: Gibt den Zeitpunkt der Transaktion an.
DE: Angabe des Datums der Transaktion.
DE: Angabe des Datums der Transaktion.
2024-10-29T12:14:00.112Z
currencyCode
CZ: Dreistellige ISO-Währungscodes - siehe die Wiki-Seite für eine Liste.
DE: Dreistelliger ISO-Währungscode.
DE: Dreistelliger ISO-Währungscode.
EUR
merchantID
CZ: Eindeutige Händler-ID, in der Regel Standort-ID. DE: Eindeutige Händler-ID, in der Regel Standort-ID
tipAmount
CZ: Tipps. Wird ausgefüllt, wenn er eingegeben wurde.
DE: Trinkgeld. Wird ausgefüllt, falls erforderlich.
DE: Trinkgeld. Wird ausgefüllt, falls erforderlich.
2
totalAmount
CZ: Gibt den Gesamtbetrag der Transaktion (einschließlich Trinkgeld) an. DE: Gibt den Gesamtbetrag der Transaktion (einschließlich Trinkgeld) an.
12
result
CZ: Antwort auf die Anfrage.
DE: Ergebnis der Anfrage.
DE: Ergebnis der Anfrage.
0 = abgeschlossen -1 = abgelehnt
cardEntryMode
CZ: Gibt an, wie die Kartendaten eingegeben wurden, z. B. Chip, kontaktlos, Magnetstreifen usw. DE: Gibt an, wie die Karte gelesen wurde: Magnetstreifen, Chip oder kontaktlos.
CONTACTLESS
transactionID
CZ: Eindeutige ID, die von der Zahlungsanwendung während der Transaktionsregistrierung generiert wird.
DE: Eindeutige ID, die von der Zahlungsanwendung während der Transaktionsregistrierung generiert wird.
DE: Eindeutige ID, die von der Zahlungsanwendung während der Transaktionsregistrierung generiert wird.
001000000
AutorisierungCode
CZ: Nur auszufüllen, wenn die Transaktion am Ende genehmigt wird.
DE: Nur auszufüllen, wenn die Transaktion bearbeitet wird.
DE: Nur auszufüllen, wenn die Transaktion bearbeitet wird.
123456
cardNumber
CZ: Kartennummer (PAN). Sie ist in maskierter Form vorhanden.
DE: Kartennummer (PAN), liegt in maskierter Form vor.
DE: Kartennummer (PAN), liegt in maskierter Form vor.
0001
pinOk
wahr/falsch
CODE
CZ: Zeigt das Ergebnis der Transaktion auf der Autorisierungsseite an.
DE: Zeigt das Transaktionsergebnis auf der Autorisierungsseite an.
DE: Zeigt das Transaktionsergebnis auf der Autorisierungsseite an.
genehmigt