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:
Vytvoření transakce
Die Transaktion kann durch einen Anruf eingeleitet werden:
gptom://transaction/create?…
kde jsou použity následující parametry pro sestavení zprávy:
Variable/Feld
Format/Format
Beschreibung/Beschreibung
Beispiel
Betrag
VERPFLICHTUNG
VERPFLICHTUNG
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: Volitelná kontrola přihlášeného uživatele. Zde se kontroluje API klíč terminálu.
EN: Optional check of the logged in user. Here the terminal API key is checked.
EN: Optional check of the logged in user. Here the terminal API key is checked.
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.
Reference number up to 20 characters - suitable for invoice number, payment - can be used for your matching of payments to sales or orders.
Reference number up to 20 characters - suitable for invoice number, payment - can be used for your matching of payments to sales or orders.
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.
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.
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.
wahr/falsch
TipAmount
long
CZ: V restauracích můžete požádat zákazníka o přidání spropitného, kde spropitného je zadáno z Vašeho systému. Tato částka se pak přičte k původní částce zadané obchodníkem.
EN: In restaurants, you can ask the customer to add a tip, where the tip is entered in your system. This amount is then added to the original amount entered by the merchant.
EN: In restaurants, you can ask the customer to add a tip, where the tip is entered in your system. This amount is then added to the original amount entered by the merchant.
1000 (=10CZK/EUR)
redirectUrl
String
CZ: URL vaší aplikace na kterou přesměrujeme klienta po dokončení platby.
EN: The URL of your application to which we will redirect the client after completing the payment.
EN: The URL of your application to which we will redirect the client after completing the payment.
fb://success
TipCollect
bool
CZ: Volitelné pole, které vyvolává obrazovku zadání spropitného v aplikaci GP tom. Po zadání spropitného v aplikaci se následně zobrazí obrazovka pro přiložení karty. Pro vyvolání této obrazovky je potřeba mít také aktivované spropitné v aplikaci.
EN: An optional field that brings up the tip entry screen in the GP tom application. After entering the tip in the application, a screen for attaching the card will be displayed. You also need to have tipping enabled in the app to bring up this screen.
EN: An optional field that brings up the tip entry screen in the GP tom application. After entering the tip in the application, a screen for attaching the card will be displayed. You also need to have tipping enabled in the app to bring up this screen.
true / false
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:Transaction Type defines the type of transaction you want to initiate. Available values are:
CASH
KARTE
KONTO_BEZAHLUNG
BLIK_PAYMENT
PAYMENT_GATEWAY
EN:Transaction Type defines the type of transaction you want to initiate. Available values are:
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: Dává odpověď v jakém stavu skončil daný požadavek
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: 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
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: Identifikuje použitý typ karty.
EN: Identifies used card type.
EN: Identifies used card type.
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: Udává celkovou čásku transakce (včetně spropitného)
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 - approved transaction
-1 - declined transaction
-1 - declined transaction
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
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.
accepted