Nachdem Sie die Transaktions-ID erhalten haben, sollte Ihre Anwendung eine Transaktionsanforderung generieren und senden. Die Zahlungsanwendung startet den gesamten Zahlungsvorgang und gibt das Ergebnis zurück. In älteren Versionen (niedriger als Version 1.2.) wurde die synchrone Kommunikation verwendet, um das Ergebnis der Transaktion zu erhalten (die Listen-Funktion ist veraltet). Für die neue Version ist die Kommunikation asynchron, wobei die getTransactionState-Methode verwendet wird, um den aktuellen Status der Transaktion abzurufen.
void transactionRequestV2(String transactionRequesJsonString, ITransactionResultListener listener) throws RemoteException
Anfrage [TransactionRequestV2Entity]
Basierend auf der Art der Transaktion sind die folgenden Felder obligatorisch/optional/optional:
[(M) erforderlich, (O) fakultativ)]
Benachrichtigung
Das Format für alle Beträge ist auf zwei Dezimalstellen, so dass zum Beispiel 50 CZK als 5000 ausgefüllt werden sollten.
Feldbeschreibung
amount
Der Betrag bestimmt das Volumen der Transaktion. Dieser Betrag wird in der vom Terminal verwendeten Landeswährung berechnet. Das Format ist auf zwei Dezimalstellen genau, so dass zum Beispiel 50 CZK als 5000 ausgefüllt werden sollten.
tipAmount
In Restaurants können Sie den Kunden auffordern, ein Trinkgeld zu geben, wobei das Trinkgeld über Ihr System eingegeben wird. Dieser Betrag wird dann zu dem ursprünglich vom Händler eingegebenen Betrag addiert.
transactionID
Eine eindeutige ID, die von der Zahlungsanwendung während des Transaktionsregistrierungsprozesses generiert wird.
clientID
transactionType
Die Vorgangsart definiert die Art der Transaktion, die Sie initiieren möchten. Die verfügbaren Werte sind:
- VERKAUF(1)
- VOID(2)
- CLOSE_BATCH (4)
originTransactionID
Es wird zum Rückgängigmachen der Transaktion verwendet und sollte die ID der Transaktion enthalten, die Sie abbrechen möchten.
originReferenceNum
Dieses Feld ist optional und kann mit einer Referenznummer gefüllt werden – einer beliebigen AN-Zeichenfolge mit maximal 20 Zeichen. Diese Kette ist in allen Transaktionsberichten sichtbar und hilft Buchhaltungsabteilungen, Zahlungen mit Aufträgen abzugleichen. Diakritische Zeichen werden nicht unterstützt.
cancelMode
2 – Ältere Transaktionen
printByPaymentApp
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" senden, wird der Benutzer unmittelbar nach der Transaktion an Ihre Anwendung zurückgegeben, und es liegt an Ihnen, die Quittung zu übergeben.
clientInfo
Wenn Sie einen Beleg direkt aus der App versenden GP tomAPI E-Mail ist es möglich, die Telefonnummer des Kunden über auszufüllen.
preferableReceiptType
Wenn Sie eine Quittung aus der App versenden GP tom API können Sie die Methode für den Versand der Quittung über vordefinieren. Mögliche Werte sind:
- TELEFON
- QR
TipCollect
Optionales Feld, welches die Maske für die Trinkgelderfassung in der App aufruft. Bitte beachten Sie, dass die Funktion auch in GP tom aktiviert sein muss, um diese zu verwenden.