Hinweis
Um die Einzelheiten einer Transaktion zu erfahren, brauchen Sie nur eine Anfrage zu stellen:
TransactionInquire(String transactionId, IInquireResultListener listener) throws RemoteException
Nachdem Sie die Transaktions-ID erhalten haben, sollte Ihre Anwendung eine Transaktionsanforderung erstellen und senden. Die Zahlungsanwendung führt den gesamten Zahlungsvorgang durch und gibt das Ergebnis zurück. In älteren Versionen (unter Version 1.2) wurde eine synchrone Kommunikation verwendet, um das Transaktionsergebnis zu erhalten (die Abhörfunktion ist veraltet). In der neuen Version erfolgt die Kommunikation asynchron, wobei die Methode getTransactionState verwendet wird, um den aktuellen Status der Transaktion zu erhalten.
void transactionRequestV2(String transactionRequesJsonString, ITransactionResultListener listener) throws RemoteException
Anfrage [TransactionRequestV2Entity]
Je nach Transaktionsart sind die folgenden Felder erforderlich/optional/optional:
[(M) obligatorisch, (O) fakultativ)]
KARTE
KONTO_BEZAHLUNG
BLIK_PAYMENT
PAYMENT_GATEWAY
Hinweis
Das Format für alle Beträge ist auf zwei Dezimalstellen genau, so dass z. B. 50 CZK als 5000 eingetragen werden müssen.
Beschreibung der Felder
Betrag
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 z. B. 50 CZK als 5000 eingegeben 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.
transaktionsID
Eine eindeutige ID, die von der Zahlungsanwendung während des Transaktionsregistrierungsprozesses generiert wird.
clientID
transactionType
Transaktionsart definiert die Art der Transaktion, die Sie initiieren möchten. Die verfügbaren Werte sind:
- VERKAUF(1)
- VOID(2)
- REFUND(3) – since version 1.75.4, AIDL 1.28
- CLOSE_BATCH(4)
originTransactionID
Sie wird verwendet, um eine Transaktion zu stornieren und sollte die ID der Transaktion enthalten, die Sie stornieren möchten.
originReferenceNum
Dieses Feld ist optional und kann mit einer Referenznummer gefüllt werden - eine beliebige AN-Zeichenkette mit maximal 20 Zeichen. Diese Zeichenfolge ist in allen Transaktionsberichten sichtbar und hilft den 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 oder vom 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.
clientInfo
Wenn Sie die Quittung direkt aus der GP tom App versenden, ist es möglich, die E-Mail oder Telefonnummer des Kunden über die API vorzubefüllen.
preferableReceiptType
Für den Fall, dass eine Quittung aus der GP tom-Anwendung gesendet wird, ist es möglich, die Methode für das Senden der Quittung über die API vorzudefinieren. Mögliche Werte sind:
- TELEFON
- QR
TipCollect
Ein optionales Feld, das den Bildschirm für die Trinkgelderfassung in der GP tom-App aufruft. Nach der Eingabe des Trinkgelds in der App wird dann der Bildschirm zum Anhängen der Karte angezeigt. Um diesen Bildschirm aufzurufen, müssen Sie in der App auch die Trinkgeldfunktion aktiviert haben
Zahlungsmethode
Seit der Version 1.64.5 haben wir die Möglichkeit hinzugefügt, zusätzliche Zahlungsmethoden über die app2app API mit Hilfe des PaymentMethod Feldes aufzurufen. Die aktuellen Optionen sind:
CASH - Barzahlungen
CARD - Kartenzahlungen
ACCOUNT_PAYMENT - Zahlung per Rechnung (neue Zahlungsmethode für den CZ-Markt)
Wenn das Feld nicht ausgefüllt ist, wird der Standardwert auf CARD gesetzt.