Eine Verkaufstransaktion ist ein grundlegender Zahlungsvorgang, der die Überweisung eines bestimmten Betrags vom Bankkonto des Karteninhabers auf das Konto des Händlers vorsieht.
Was den Zahlungsvorgang betrifft, so ist das Verfahren wie folgt:
Erstellen einer Transaktion
Die Transaktion kann durch einen Anruf eingeleitet werden:
gptom://transaction/create?…
wobei die folgenden Parameter zur Erstellung des Berichts verwendet werden:
Variable/Feld
Format/Format
Beschreibung/Beschreibung
Beispiel
amount
OBLIGATORISCH
OBLIGATORISCH
lang
CZ: Transaktionsbetrag mit zwei Dezimalstellen.
DE: Transaktionsbetrag mit zwei Dezimalstellen.
DE: Transaktionsbetrag mit zwei Dezimalstellen.
1000 (=10CZK/EURO)
clientID
string
originReferenceNum
string
CZ: Referenznummer bis zu 20 Zeichen - geeignet für Rechnungsnummer, Zahlung - kann für Ihren Zahlungsabgleich mit Verkäufen oder Aufträgen verwendet werden.
Referenznummer bis zu 20 Zeichen - geeignet für Rechnungsnummer, Zahlung - kann für Ihren Abgleich von Zahlungen mit Verkäufen oder Aufträgen verwendet werden.
Referenznummer bis zu 20 Zeichen - geeignet für Rechnungsnummer, Zahlung - kann für Ihren Abgleich von Zahlungen mit Verkäufen oder Aufträgen verwendet werden.
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.
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 an Ihre Anwendung zurückgegeben und es liegt an Ihnen, die Quittung zu übergeben.
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 an Ihre Anwendung zurückgegeben und es liegt an Ihnen, die Quittung zu übergeben.
wahr/falsch
tipAmount
lang
CZ: In Restaurants können Sie den Kunden auffordern, ein Trinkgeld zu geben, wobei das Trinkgeld von Ihrem System eingegeben wird. Dieser Betrag wird dann zu dem ursprünglich vom Händler eingegebenen Betrag addiert.
DE: In Restaurants können Sie den Kunden auffordern, ein Trinkgeld zu geben, wobei das Trinkgeld in Ihr System eingegeben wird. Dieser Betrag wird dann zu dem ursprünglich vom Händler eingegebenen Betrag addiert.
DE: In Restaurants können Sie den Kunden auffordern, ein Trinkgeld zu geben, wobei das Trinkgeld in Ihr System eingegeben wird. Dieser Betrag wird dann zu dem ursprünglich vom Händler eingegebenen Betrag addiert.
1000 (=10CZK/EURO)
redirectUrl
string
CZ: URL Ihrer Anwendung, zu der wir den Kunden nach Abschluss der Zahlung umleiten.
DE: Die URL Ihrer Anwendung, zu der wir den Kunden nach Abschluss der Zahlung umleiten werden.
DE: Die URL Ihrer Anwendung, zu der wir den Kunden nach Abschluss der Zahlung umleiten werden.
fb://success
TipCollect
bool
CZ: Optionales Feld, das den Bildschirm für die Trinkgelderfassung in der App aufruft GP tom. Nach der Eingabe des Trinkgelds in der App wird der Bildschirm zum Anhängen der Karte angezeigt. Um diesen Bildschirm aufzurufen, müssen Sie auch das Trinkgeld in der App aktiviert haben.
DE: Ein optionales Feld, das den Bildschirm für die Trinkgelderfassung in der GP tom Anwendung aufruft. Nach Eingabe des Trinkgelds in der Anwendung wird ein Bildschirm zum Anhängen der Karte angezeigt. Um diesen Bildschirm aufzurufen, muss in der App ebenfalls die Trinkgeldfunktion aktiviert sein.
DE: Ein optionales Feld, das den Bildschirm für die Trinkgelderfassung in der GP tom Anwendung aufruft. Nach Eingabe des Trinkgelds in der Anwendung wird ein Bildschirm zum Anhängen der Karte angezeigt. Um diesen Bildschirm aufzurufen, muss in der App ebenfalls die Trinkgeldfunktion aktiviert sein.
wahr / falsch
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
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
transactionType
string
DE: Transaktionsart definiert die Art der Transaktion, die Sie einleiten wollen.
Verfügbare Werte sind: DE:Transaktionsart definiert die Art der Transaktion, die Sie einleiten möchten.
Verfügbare Werte sind: CASH CARD
Verfügbare Werte sind: DE:Transaktionsart definiert die Art der Transaktion, die Sie einleiten möchten.
Verfügbare Werte sind: CASH CARD
BARGELD/KARTE
Beispielanruf:
gptom://transaction/create?originReferenceNum=12345&amount=2&clientID=123&tipCollect=true&preferableReceiptType=QR&redirectUrl=gp://transaction/create&printByPaymentApp=true&clientPhone=+420606505404&clientEmail=info@gptom.com&tipAmount=1
Die Antwort wird die folgenden Felder enthalten:
Feld/Feld
Format
Beschreibung/Beschreibung
Beispiel/Beispiel
AUFGABENSTATUS
DE: Gibt Auskunft darüber, in welchem Zustand Ihre Anfrage beendet ist. DE: Gibt Auskunft darüber, in welchem Zustand Ihre Anfrage beendet ist.
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.
emvaid
CZ: Gibt die EMV-Anwendung an, die für die Verarbeitung der Transaktion verwendet wird.
DE: Gibt die EMV-Anwendung an, die für die Verarbeitung der Transaktion verwendet wird.
DE: Gibt die EMV-Anwendung an, die für die Verarbeitung der Transaktion verwendet wird.
A0000000031010
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
cardType
CZ: Gibt den Typ der verwendeten Karte an.
DE: Kennzeichnet den verwendeten Kartentyp.
DE: Kennzeichnet den verwendeten Kartentyp.
VISA MASTER
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 - genehmigte Transaktion -1 - abgelehnte Transaktion
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: 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
AutorisierungCode
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
pinOk
wahr/falsch
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
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.
akzeptiert