Eine Verkaufstransaktion ist ein grundlegender Zahlungsvorgang, bei dem ein festgelegter Betrag vom Bankkonto des Karteninhabers auf das Konto des Händlers überwiesen wird.
Was den Zahlungsablauf betrifft, ist wie folgt vorzugehen:
Transaktion erstellen
Die Transaktion kann durch einen Anruf eingeleitet werden:
gptom://transaction/create?…
wobei die folgenden Parameter für die Erstellung des Berichts verwendet werden:
Variable/Feld
Format/Format
Beschreibung/Beschreibung
Beispiel
Betrag
VERPFLICHTUNG
VERPFLICHTUNG
lang
CZ: Transaktionsbetrag mit zwei Dezimalstellen.
EN: Transaktionsbetrag mit zwei Dezimalstellen.
EN: Transaktionsbetrag mit zwei Dezimalstellen.
1000 (= 10 CZK/EUR)
clientID
String
CZ: Optionale Überprüfung des angemeldeten Benutzers. Hier wird der API-Schlüssel des Terminals überprüft.
EN: Optionale Überprüfung des angemeldeten Benutzers. Hier wird der Terminal-API-Schlüssel überprüft.
EN: Optionale Überprüfung des angemeldeten Benutzers. Hier wird der Terminal-API-Schlüssel überprüft.
originReferenceNum
String
CZ: Referenznummer mit bis zu 20 Zeichen – geeignet für Rechnungs- und Zahlungsnummern – kann zum Abgleich Ihrer Zahlungen mit Verkäufen oder Bestellungen verwendet werden.
Referenznummer mit bis zu 20 Zeichen – geeignet für Rechnungsnummern, Zahlungen – kann zum Abgleich von Zahlungen mit Verkäufen oder Bestellungen verwendet werden.
Referenznummer mit bis zu 20 Zeichen – geeignet für Rechnungsnummern, Zahlungen – kann zum Abgleich von Zahlungen mit Verkäufen oder Bestellungen verwendet werden.
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.
Legt fest, ob die Quittung vom Kunden durch Ihre Anwendung oder durch GP tom übermittelt wird. Der Standardwert ist "true" (d. h., GP bietet eine Möglichkeit, die Quittung an den Kunden zu übermitteln). Wenn Sie den Wert „false“ übermitteln, leiten wir den Nutzer unmittelbar nach der Transaktion zurück zu Ihrer App, und es liegt an Ihnen, die Quittung zu übermitteln.
Legt fest, ob die Quittung vom Kunden durch Ihre Anwendung oder durch GP tom übermittelt wird. Der Standardwert ist "true" (d. h., GP bietet eine Möglichkeit, die Quittung an den Kunden zu übermitteln). Wenn Sie den Wert „false“ übermitteln, leiten wir den Nutzer unmittelbar nach der Transaktion zurück zu Ihrer App, und es liegt an Ihnen, die Quittung zu übermitteln.
wahr/falsch
TipAmount
lang
CZ: In Restaurants können Sie den Kunden bitten, ein Trinkgeld hinzuzufügen, wobei das Trinkgeld über Ihr System eingegeben wird. Dieser Betrag wird dann zum ursprünglich vom Verkäufer eingegebenen Betrag hinzugerechnet.
EN: In Restaurants können Sie den Kunden bitten, ein Trinkgeld hinzuzufügen, das dann in Ihr System eingegeben wird. Dieser Betrag wird anschließend zu dem vom Händler ursprünglich eingegebenen Betrag hinzugerechnet.
EN: In Restaurants können Sie den Kunden bitten, ein Trinkgeld hinzuzufügen, das dann in Ihr System eingegeben wird. Dieser Betrag wird anschließend zu dem vom Händler ursprünglich eingegebenen Betrag hinzugerechnet.
1000 (= 10 CZK/EUR)
redirectUrl
String
CZ: Die URL Ihrer Anwendung, zu der wir den Kunden nach Abschluss der Zahlung weiterleiten.
EN: Die URL Ihrer Anwendung, zu der wir den Kunden nach Abschluss der Zahlung weiterleiten werden.
EN: Die URL Ihrer Anwendung, zu der wir den Kunden nach Abschluss der Zahlung weiterleiten werden.
fb://success
TipCollect
bool
CZ: Ein optionales Feld, das in der GP-App den Bildschirm zur Eingabe des Trinkgelds aufruft. Nach der Eingabe des Trinkgelds in der App wird anschließend der Bildschirm zum Anlegen der Karte angezeigt. Um diesen Bildschirm aufzurufen, muss die Trinkgeldfunktion in der App aktiviert sein.
EN: Ein optionales Feld, das den Bildschirm zur Eingabe des Trinkgelds in der GP-tom-App öffnet. Nachdem Sie das Trinkgeld in der App eingegeben haben, wird ein Bildschirm zum Anbringen der Karte angezeigt. Damit dieser Bildschirm erscheint, muss die Trinkgeldfunktion in der App aktiviert sein.
EN: Ein optionales Feld, das den Bildschirm zur Eingabe des Trinkgelds in der GP-tom-App öffnet. Nachdem Sie das Trinkgeld in der App eingegeben haben, wird ein Bildschirm zum Anbringen der Karte angezeigt. Damit dieser Bildschirm erscheint, muss die Trinkgeldfunktion in der App aktiviert sein.
wahr / falsch
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
QR
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
QR
Text
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
transactionType
String
DE: Die Transaktionsart legt die Art der Transaktion fest, die Sie einleiten möchten. Die verfügbaren Werte sind:
EN:Der Transaktionstyp legt fest, welche Art von Transaktion Sie auslösen möchten. Folgende Werte stehen zur Auswahl:
CASH
KARTE
KONTO_BEZAHLUNG
BLIK_PAYMENT
PAYMENT_GATEWAY
EN:Der Transaktionstyp legt fest, welche Art von Transaktion Sie auslösen möchten. Folgende Werte stehen zur Auswahl:
CASH
KARTE
KONTO_BEZAHLUNG
BLIK_PAYMENT
PAYMENT_GATEWAY
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
CZ: Gibt Auskunft darüber, in welchem Status die jeweilige Anforderung abgeschlossen 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.
emvAid
CZ: Identifiziert die für die Transaktionsabwicklung verwendete EMV-Anwendung.
EN: Identifiziert die EMV-App, die für die Transaktionsverarbeitung verwendet wird.
EN: Identifiziert die EMV-App, die für die Transaktionsverarbeitung verwendet wird.
A0000000031010
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
cardType
CZ: Identifiziert den verwendeten Kartentyp.
EN: Gibt den verwendeten Kartentyp an.
EN: Gibt den verwendeten Kartentyp an.
VISA
MASTER
MASTER
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.
DE: Tipp. Bei Bedarf auszufüllen.
DE: Tipp. Bei Bedarf auszufüllen.
2
totalAmount
CZ: Gibt den Gesamtbetrag der Transaktion an (einschließlich Trinkgeld)
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 – genehmigte Transaktion
-1 – abgelehnte Transaktion
-1 – abgelehnte Transaktion
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: 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
authorizationCode
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
pinOk
wahr/falsch
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
dccData:
Status
CZ: Gibt den DCC-Status an. Bei "ACCEPTED" wurde die Transaktion über DCC abgewickelt, und Sie müssen den DCC-Beleg mit den entsprechenden Daten ausfüllen. Bei "NOT_ACCEPTED" können Sie die DCC-Daten ignorieren.
DE: Zeigt den DCC-Status an. Bei "ACCEPTED" wurde die Transaktion über DCC abgewickelt, und Sie müssen die Quittung mit den DCC-Daten ausfüllen. Bei "NOT_ACCEPTED" können Sie die DCC-Daten ignorieren.
DE: Zeigt den DCC-Status an. Bei "ACCEPTED" wurde die Transaktion über DCC abgewickelt, und Sie müssen die Quittung mit den DCC-Daten ausfüllen. Bei "NOT_ACCEPTED" können Sie die DCC-Daten ignorieren.
AKZEPTIERT
NOT_ACCEPTED
NOT_ACCEPTED
Währung
DE: Währung der Kundenkarte.
EN: Währung der Kundenkarte.
EN: Währung der Kundenkarte.
CZK
Betrag
DE: Transaktionsbetrag in der DCC-Währung – in der Währung der Kundenkarte. Er muss genau so angezeigt werden, wie er in der API-Antwort erscheint, einschließlich der Anzahl der Dezimalstellen.
EN: Transaktionsbetrag in DCC-Währung – in der Währung der Kundenkarte. Sie müssen diesen Betrag auf Ihrem Beleg genau so ausweisen, wie er in der API-Antwort angegeben wurde, einschließlich der korrekten Dezimalstellen.
EN: Transaktionsbetrag in DCC-Währung – in der Währung der Kundenkarte. Sie müssen diesen Betrag auf Ihrem Beleg genau so ausweisen, wie er in der API-Antwort angegeben wurde, einschließlich der korrekten Dezimalstellen.
61.02
Markup
DE: Aufschlag auf den Umrechnungskurs. Er muss genau so angezeigt werden, wie er in der API-Antwort erscheint, einschließlich der Anzahl der Dezimalstellen.
EN: Angabe der Umrechnungsrate. Sie müssen diese auf Ihrem Beleg genau so angeben, wie sie in der API-Antwort angegeben wurde, einschließlich der korrekten Dezimalstellen.
EN: Angabe der Umrechnungsrate. Sie müssen diese auf Ihrem Beleg genau so angeben, wie sie in der API-Antwort angegeben wurde, einschließlich der korrekten Dezimalstellen.
9.9
Wechselkurs
DE: Gibt den Wechselkurs an. Dieser Wert ist in der Landeswährung des Terminals angegeben. Er muss genau so angezeigt werden, wie er in der API-Antwort erscheint, einschließlich der Anzahl der Dezimalstellen.
EN: Gibt den Wechselkurs an. Dieser Wert ist in der lokalen Terminalwährung angegeben. Sie müssen ihn auf Ihrem Beleg genau so angeben, wie er in der API-Antwort erhalten wurde, einschließlich der korrekten Dezimalstellen.
EN: Gibt den Wechselkurs an. Dieser Wert ist in der lokalen Terminalwährung angegeben. Sie müssen ihn auf Ihrem Beleg genau so angeben, wie er in der API-Antwort erhalten wurde, einschließlich der korrekten Dezimalstellen.
24.567
regionSchemaIndicator
CZ: Gibt an, ob die Kundenkarte innerhalb oder außerhalb der EU ausgestellt wurde. Wenn der Wert "0" oder "1" lautet, muss auf dem Kassenbon der Text "Markup" angezeigt werden. Wenn der Wert "2" lautet, muss auf dem Kassenbon "Markup over ECB rate“ angezeigt werden.
DE: Gibt an, ob die Karte des Kunden innerhalb oder außerhalb der EU ausgestellt wurde. Wenn der Wert "0" oder "1" lautet, muss auf dem Beleg der Text "Aufschlag" angezeigt werden. Wenn der Wert "2" lautet, muss auf dem Beleg der Text "Aufschlag gegenüber dem EZB-Kurs" angezeigt werden.
DE: Gibt an, ob die Karte des Kunden innerhalb oder außerhalb der EU ausgestellt wurde. Wenn der Wert "0" oder "1" lautet, muss auf dem Beleg der Text "Aufschlag" angezeigt werden. Wenn der Wert "2" lautet, muss auf dem Beleg der Text "Aufschlag gegenüber dem EZB-Kurs" angezeigt werden.
0
1
2
1
2
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.
akzeptiert