Μετά τη λήψη του αναγνωριστικού συναλλαγής, η εφαρμογή σας θα πρέπει να δημιουργήσει και να στείλει ένα αίτημα συναλλαγής. Η εφαρμογή πληρωμής θα εκτελέσει ολόκληρη τη διαδικασία πληρωμής και θα επιστρέψει το αποτέλεσμα. Σε παλαιότερες εκδόσεις (κάτω από την έκδοση 1.2), χρησιμοποιούνταν η σύγχρονη επικοινωνία για τη λήψη του αποτελέσματος της συναλλαγής (η λειτουργία ακρόασης έχει καταργηθεί). Για τη νέα έκδοση, η επικοινωνία είναι ασύγχρονη, όπου η μέθοδος getTransactionState χρησιμοποιείται για να ληφθεί η τρέχουσα κατάσταση της συναλλαγής.
void transactionRequestV2(String transactionRequesJsonString, ITransactionResultListener listener) throws RemoteException
Αίτηση [TransactionRequestV2Entity]
Με βάση τον τύπο συναλλαγής, τα ακόλουθα πεδία είναι υποχρεωτικά/προαιρετικά/προαιρετικά:
[(M) υποχρεωτικό, (O) προαιρετικό)]
Ανακοίνωση
Η μορφή όλων των ποσών είναι με δύο δεκαδικά ψηφία, οπότε για παράδειγμα 50 CZK θα πρέπει να συμπληρωθούν ως 5000.
Περιγραφή των πεδίων
ποσό
Το ποσό καθορίζει τον όγκο της συναλλαγής. Το ποσό αυτό υπολογίζεται στο εγχώριο νόμισμα που χρησιμοποιείται από το τερματικό. Η μορφή είναι με δύο δεκαδικά ψηφία, οπότε για παράδειγμα 50 CZK θα πρέπει να συμπληρωθούν ως 5000.
TipAmount
Στα εστιατόρια μπορείτε να ζητήσετε από τον πελάτη να προσθέσει φιλοδώρημα, όπου το φιλοδώρημα καταχωρείται στο σύστημά σας. Το ποσό αυτό προστίθεται στη συνέχεια στο αρχικό ποσό που εισήγαγε ο έμπορος.
transactionID
Μοναδικό αναγνωριστικό που παράγεται από την εφαρμογή πληρωμών κατά τη διαδικασία καταχώρισης της συναλλαγής.
clientID
transactionType
Ο Τύπος συναλλαγής καθορίζει τον τύπο της συναλλαγής που θέλετε να ξεκινήσετε. Οι διαθέσιμες τιμές είναι οι εξής:
- ΠΩΛΗΣΗ(1)
- VOID(2)
- CLOSE_BATCH(4)
originTransactionID
Χρησιμοποιείται για την ακύρωση μιας συναλλαγής και πρέπει να περιέχει το αναγνωριστικό της συναλλαγής που θέλετε να ακυρώσετε.
originReferenceNum
Αυτό το πεδίο είναι προαιρετικό και μπορεί να συμπληρωθεί με έναν αριθμό αναφοράς - οποιαδήποτε συμβολοσειρά AN με μέγιστο αριθμό 20 χαρακτήρων. Αυτή η συμβολοσειρά είναι ορατή σε όλες τις αναφορές συναλλαγών και βοηθά τα λογιστήρια να αντιστοιχίσουν τις πληρωμές με τις παραγγελίες. Δεν υποστηρίζονται οι διακριτικοί χαρακτήρες.
cancelMode
2 - Παλαιότερες συναλλαγές
printByPaymentApp
Καθορίζει αν η απόδειξη διαβιβάζεται στον πελάτη από την εφαρμογή σας ή από το GP tom. Η προεπιλεγμένη τιμή είναι true (δηλαδή το GP tom θα προσφέρει τη μέθοδο διαβίβασης της απόδειξης στον πελάτη). Εάν στείλετε την τιμή "false", θα επιστρέψουμε τον χρήστη στην εφαρμογή σας αμέσως μετά τη συναλλαγή και εναπόκειται σε εσάς να περάσετε την απόδειξη.
clientInfo
Εάν στέλνετε την απόδειξη απευθείας από την εφαρμογή GP tom, είναι δυνατή η προσυμπλήρωση του email ή του αριθμού τηλεφώνου του πελάτη μέσω του API.
preferableReceiptType
Σε περίπτωση αποστολής απόδειξης από την εφαρμογή GP tom, είναι δυνατό να προκαθορίσετε τη μέθοδο αποστολής της απόδειξης μέσω API. Πιθανές τιμές είναι οι εξής: 1:
- ΤΗΛΕΦΩΝΟ
- QR
- ΕΚΤΥΠΩΣΗ
TipCollect
Ένα προαιρετικό πεδίο που εμφανίζει την οθόνη καταχώρησης φιλοδωρήματος στην εφαρμογή GP tom. Μετά την εισαγωγή του φιλοδωρήματος στην εφαρμογή, εμφανίζεται στη συνέχεια η οθόνη για την επισύναψη της κάρτας. Για να εμφανιστεί αυτή η οθόνη, πρέπει επίσης να έχετε ενεργοποιήσει το φιλοδώρημα στην εφαρμογή