Η συναλλαγή πώλησης είναι μια βασική πράξη πληρωμής που μεταφέρει ένα συγκεκριμένο ποσό από τον τραπεζικό λογαριασμό του κατόχου της κάρτας στον λογαριασμό του εμπόρου.
Όσον αφορά τη διαδικασία πληρωμής, η διαδικασία έχει ως εξής:
Δημιουργία συναλλαγής
Η συναλλαγή μπορεί να ξεκινήσει καλώντας:
gptom://transaction/create?…
όπου χρησιμοποιούνται οι ακόλουθες παράμετροι για τη δημιουργία της έκθεσης:
Μεταβλητή/πεδίο
Μορφή/μορφή
Περιγραφή/Περιγραφή
Παράδειγμα
ποσό ΥΠΟΧΡΕΩΤΙΚΟ
μακρύ
CZ: Ποσό συναλλαγής με δύο δεκαδικά ψηφία.
EL: Ποσό συναλλαγής με δύο δεκαδικά ψηφία.
EL: Ποσό συναλλαγής με δύο δεκαδικά ψηφία.
1000 (=10CZK/ΕΥΡΏ)
clientID
string
originReferenceNum
string
CZ: Αριθμός αναφοράς έως 20 χαρακτήρες - κατάλληλος για αριθμό τιμολογίου, πληρωμή - μπορεί να χρησιμοποιηθεί για την αντιστοίχιση της πληρωμής σας με τις πωλήσεις ή τις παραγγελίες.
Αριθμός αναφοράς έως 20 χαρακτήρες - κατάλληλος για αριθμό τιμολογίου, πληρωμή - μπορεί να χρησιμοποιηθεί για την αντιστοίχιση των πληρωμών σας με πωλήσεις ή παραγγελίες.
Αριθμός αναφοράς έως 20 χαρακτήρες - κατάλληλος για αριθμό τιμολογίου, πληρωμή - μπορεί να χρησιμοποιηθεί για την αντιστοίχιση των πληρωμών σας με πωλήσεις ή παραγγελίες.
printByPaymentApp
bool
CZ: Καθορίζει αν η απόδειξη διαβιβάζεται στον πελάτη από την εφαρμογή σας ή από την GP tom. Η προεπιλεγμένη τιμή είναι true (δηλαδή το GP tom θα προσφέρει τη μέθοδο διαβίβασης της απόδειξης στον πελάτη). Εάν στείλετε την τιμή "false", θα επιστρέψουμε τον χρήστη στην εφαρμογή σας αμέσως μετά τη συναλλαγή και εναπόκειται σε εσάς να περάσετε την απόδειξη.
Καθορίζει εάν η απόδειξη διαβιβάζεται στον πελάτη από την εφαρμογή σας ή από την GP tom. Η προεπιλεγμένη τιμή είναι true (δηλ. το GP θα προσφέρει έναν τρόπο να περάσει την απόδειξη στον πελάτη). Εάν στείλετε την τιμή "false", επιστρέφουμε τον χρήστη στην εφαρμογή σας αμέσως μετά τη συναλλαγή και εναπόκειται σε εσάς να περάσετε την απόδειξη.
Καθορίζει εάν η απόδειξη διαβιβάζεται στον πελάτη από την εφαρμογή σας ή από την GP tom. Η προεπιλεγμένη τιμή είναι true (δηλ. το GP θα προσφέρει έναν τρόπο να περάσει την απόδειξη στον πελάτη). Εάν στείλετε την τιμή "false", επιστρέφουμε τον χρήστη στην εφαρμογή σας αμέσως μετά τη συναλλαγή και εναπόκειται σε εσάς να περάσετε την απόδειξη.
αληθές/ψευδές
TipAmount
μακρύ
CZ: Στα εστιατόρια, μπορείτε να ζητήσετε από τον πελάτη να προσθέσει φιλοδώρημα, όπου το φιλοδώρημα εισάγεται από το σύστημά σας. Το ποσό αυτό προστίθεται στη συνέχεια στο αρχικό ποσό που εισήγαγε ο έμπορος.
EL: Στα εστιατόρια, μπορείτε να ζητήσετε από τον πελάτη να προσθέσει ένα φιλοδώρημα, όπου το φιλοδώρημα εισάγεται στο σύστημά σας. Το ποσό αυτό προστίθεται στη συνέχεια στο αρχικό ποσό που εισήγαγε ο έμπορος.
EL: Στα εστιατόρια, μπορείτε να ζητήσετε από τον πελάτη να προσθέσει ένα φιλοδώρημα, όπου το φιλοδώρημα εισάγεται στο σύστημά σας. Το ποσό αυτό προστίθεται στη συνέχεια στο αρχικό ποσό που εισήγαγε ο έμπορος.
1000 (=10CZK/ΕΥΡΏ)
redirectUrl
string
CZ: URL της εφαρμογής σας στην οποία ανακατευθύνουμε τον πελάτη μετά την ολοκλήρωση της πληρωμής.
EN: Η διεύθυνση URL της εφαρμογής σας στην οποία θα ανακατευθύνουμε τον πελάτη μετά την ολοκλήρωση της πληρωμής.
EN: Η διεύθυνση URL της εφαρμογής σας στην οποία θα ανακατευθύνουμε τον πελάτη μετά την ολοκλήρωση της πληρωμής.
fb://success
TipCollect
bool
CZ: Προαιρετικό πεδίο που εμφανίζει την οθόνη καταχώρησης φιλοδωρήματος στην εφαρμογή GP tom. Μετά την εισαγωγή του φιλοδωρήματος στην εφαρμογή, εμφανίζεται στη συνέχεια η οθόνη για την επισύναψη της κάρτας. Για να εμφανιστεί αυτή η οθόνη, πρέπει επίσης να έχετε ενεργοποιήσει το φιλοδώρημα στην εφαρμογή.
EL: Ένα προαιρετικό πεδίο που εμφανίζει την οθόνη εισαγωγής φιλοδωρήματος στην εφαρμογή GP tom. Μετά την εισαγωγή του φιλοδωρήματος στην εφαρμογή, θα εμφανιστεί η οθόνη για την επισύναψη της κάρτας. Για να εμφανιστεί αυτή η οθόνη, πρέπει επίσης να έχετε ενεργοποιήσει το φιλοδώρημα στην εφαρμογή.
EL: Ένα προαιρετικό πεδίο που εμφανίζει την οθόνη εισαγωγής φιλοδωρήματος στην εφαρμογή GP tom. Μετά την εισαγωγή του φιλοδωρήματος στην εφαρμογή, θα εμφανιστεί η οθόνη για την επισύναψη της κάρτας. Για να εμφανιστεί αυτή η οθόνη, πρέπει επίσης να έχετε ενεργοποιήσει το φιλοδώρημα στην εφαρμογή.
αληθές / ψευδές
preferableReceiptType
enum (sms,email,qr,print)
CZ: Σε περίπτωση αποστολής απόδειξης από την εφαρμογή GP tom, είναι δυνατόν να προκαθορίσετε τη μέθοδο αποστολής της απόδειξης μέσω API.
Οι πιθανές τιμές είναι: EL: Σε περίπτωση αποστολής απόδειξης από την εφαρμογή GP tom, είναι δυνατόν να προκαθοριστεί η μέθοδος αποστολής της απόδειξης μέσω του API.
Οι πιθανές τιμές είναι: PHONE EMAIL QR PRINT
Οι πιθανές τιμές είναι: EL: Σε περίπτωση αποστολής απόδειξης από την εφαρμογή GP tom, είναι δυνατόν να προκαθοριστεί η μέθοδος αποστολής της απόδειξης μέσω του API.
Οι πιθανές τιμές είναι: PHONE EMAIL QR PRINT
κείμενο
clientPhone
string
CZ: Αριθμός τηλεφώνου του πελάτη.
EL: Αριθμός τηλεφώνου πελάτη.
EL: Αριθμός τηλεφώνου πελάτη.
+420606505404
clientEmail
string
CZ: Διεύθυνση ηλεκτρονικού ταχυδρομείου του πελάτη.
EL: Διεύθυνση ηλεκτρονικού ταχυδρομείου του πελάτη.
EL: Διεύθυνση ηλεκτρονικού ταχυδρομείου του πελάτη.
info@gptom.com
transactionType
string
EL: Ο τύπος συναλλαγής καθορίζει τον τύπο της συναλλαγής που θέλετε να ξεκινήσετε.
Οι διαθέσιμες τιμές είναι: EL: Transaction Type (Τύπος συναλλαγής) ορίζει τον τύπο της συναλλαγής που θέλετε να ξεκινήσετε.
Οι διαθέσιμες τιμές είναι: CASH CARD
Οι διαθέσιμες τιμές είναι: EL: Transaction Type (Τύπος συναλλαγής) ορίζει τον τύπο της συναλλαγής που θέλετε να ξεκινήσετε.
Οι διαθέσιμες τιμές είναι: CASH CARD
ΜΕΤΡΗΤΆ/ΚΆΡΤΑ
Παράδειγμα κλήσης:
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
Η απάντηση θα περιέχει τα ακόλουθα πεδία:
Πεδίο/Πεδίο
Μορφή
Περιγραφή/Περιγραφή
Παράδειγμα/Παράδειγμα
ΚΑΤΑΣΤΑΣΗ ΕΡΓΑΣΙΑΣ
EL: Παρέχει πληροφορίες σε ποια κατάσταση έχει λήξει το αίτημά σας. EL: Παρέχει πληροφορίες σε ποια κατάσταση έχει λήξει το αίτημά σας.
ΟΛΟΚΛΗΡΏΘΗΚΕ ΑΚΥΡΏΘΗΚΕ ΣΦΆΛΜΑ
terminalID
CZ: ID του τερματικού στο οποίο υποβάλλονται σε επεξεργασία οι συναλλαγές.
Προσδιορίζει το τερματικό στα συστήματα GP. EL: Μοναδικό αναγνωριστικό τερματικού, στο οποίο επεξεργάζεται η συναλλαγή.
Προσδιορίζει το τερματικό στα συστήματα GP. EL: Μοναδικό αναγνωριστικό τερματικού, στο οποίο επεξεργάζεται η συναλλαγή.
12345678
ποσό
CZ: Το ποσό καθορίζει τον όγκο της συναλλαγής. Το ποσό αυτό υπολογίζεται στο εγχώριο νόμισμα που χρησιμοποιείται από το τερματικό. Για ένα κλείσιμο, περιλαμβάνει όλες τις συναλλαγές με κάρτα, πιστωμένες μείον χρεωμένες.
EL: Το ποσό καθορίζει τον όγκο της συναλλαγής. Το ποσό αυτό υπολογίζεται στο εγχώριο νόμισμα που χρησιμοποιείται από το τερματικό. Κατά την ημέρα κλεισίματος, περιλαμβάνει όλες τις συναλλαγές με κάρτα, πιστωμένες μείον χρεωστικές.
EL: Το ποσό καθορίζει τον όγκο της συναλλαγής. Το ποσό αυτό υπολογίζεται στο εγχώριο νόμισμα που χρησιμοποιείται από το τερματικό. Κατά την ημέρα κλεισίματος, περιλαμβάνει όλες τις συναλλαγές με κάρτα, πιστωμένες μείον χρεωστικές.
10
batchNumber
CZ: Προσδιορίζει τον αριθμό κλεισίματος. Συμπληρώνεται εάν ζητείται προθεσμία.
EL: Καθορίζει τον αριθμό παρτίδας. Παρουσιάζεται κατά τη συναλλαγή κλεισίματος παρτίδας.
EL: Καθορίζει τον αριθμό παρτίδας. Παρουσιάζεται κατά τη συναλλαγή κλεισίματος παρτίδας.
1
emvAppLabel
CZ: Το όνομα του EMV που χρησιμοποιήθηκε στην πληρωμή.
EL: Ετικέτα της κάρτας που χρησιμοποιήθηκε
EL: Ετικέτα της κάρτας που χρησιμοποιήθηκε
Χρεωστική κάρτα Visa
amsID
CZ: Μοναδικός αριθμός συναλλαγής.
EL: Μοναδικός αριθμός συναλλαγής.
EL: Μοναδικός αριθμός συναλλαγής.
emvAid
CZ: Προσδιορίζει την εφαρμογή EMV που χρησιμοποιήθηκε για τη διεκπεραίωση της συναλλαγής.
EL: Προσδιορίζει την εφαρμογή EMV που χρησιμοποιήθηκε για την επεξεργασία της συναλλαγής.
EL: Προσδιορίζει την εφαρμογή EMV που χρησιμοποιήθηκε για την επεξεργασία της συναλλαγής.
A0000000031010
referenceNumber
CZ: Αριθμός αναφοράς που αναγράφεται κατά την αίτηση πληρωμής.
EL: Αριθμός αναφοράς που αναγράφεται κατά την αίτηση πληρωμής
EL: Αριθμός αναφοράς που αναγράφεται κατά την αίτηση πληρωμής
ABC123
sequenceNumber
CZ: Χρησιμοποιείται για συναλλαγές ακύρωσης. Χρησιμοποιήστε τη ληφθείσα αξία που ήταν μέρος της συναλλαγής που θέλετε να ακυρώσετε.
EL: Χρησιμοποιείται για την ακύρωση συναλλαγών. Χρησιμοποιείται η ληφθείσα τιμή που αποτελούσε μέρος της συναλλαγής που θέλετε να ακυρώσετε.
EL: Χρησιμοποιείται για την ακύρωση συναλλαγών. Χρησιμοποιείται η ληφθείσα τιμή που αποτελούσε μέρος της συναλλαγής που θέλετε να ακυρώσετε.
001000000
cardType
CZ: Προσδιορίζει τον τύπο της κάρτας που χρησιμοποιείται.
EL: Προσδιορίζει τον τύπο της χρησιμοποιούμενης κάρτας.
EL: Προσδιορίζει τον τύπο της χρησιμοποιούμενης κάρτας.
VISA MASTER
transactionType
EL: Καθορίζει τον τύπο συναλλαγής.
EL: Καθορίζει τον τύπο της συναλλαγής.
EL: Καθορίζει τον τύπο της συναλλαγής.
ΚΑΡΤΑ
ημερομηνία
CZ: Δείχνει την ώρα της συναλλαγής.
EL: Δίνει την ημερομηνία της συναλλαγής.
EL: Δίνει την ημερομηνία της συναλλαγής.
2024-10-29T12:14:00.112Z
currencyCode
CZ: Τριψήφιοι κωδικοί νομισμάτων ISO - δείτε τη σελίδα Wiki για έναν κατάλογο.
EL: Τριψήφιος κωδικός ISO νομίσματος.
EL: Τριψήφιος κωδικός ISO νομίσματος.
EUR
merchantID
CZ: Μοναδικό αναγνωριστικό εμπόρου, συνήθως αναγνωριστικό τοποθεσίας. EL: Μοναδικό αναγνωριστικό εμπόρου, συνήθως αναγνωριστικό τοποθεσίας.
TipAmount
CZ: Συμβουλές. Συμπληρώνεται εάν έχει καταχωρηθεί.
EL: Συμβουλή. Συμπληρώνεται εάν χρειάζεται.
EL: Συμβουλή. Συμπληρώνεται εάν χρειάζεται.
2
totalAmount
CZ: Δείχνει το συνολικό ποσό της συναλλαγής (συμπεριλαμβανομένου του φιλοδωρήματος) EL: Δείχνει το συνολικό ποσό της συναλλαγής (συμπεριλαμβανομένου του φιλοδωρήματος)
12
αποτέλεσμα
CZ: Απάντηση στο αίτημα.
EL: Αποτέλεσμα στην αίτηση.
EL: Αποτέλεσμα στην αίτηση.
0 - εγκεκριμένη συναλλαγή -1 - απορριφθείσα συναλλαγή
cardEntryMode
CZ: Προσδιορίζει τον τρόπο εισαγωγής των δεδομένων της κάρτας, όπως τσιπ, ανέπαφη κάρτα, μαγνητική ταινία κ.λπ. EL: Προσδιορίζει τον τρόπο ανάγνωσης της κάρτας: μαγνητική ταινία, τσιπ ή ανέπαφη κάρτα.
CONTACTLESS
transactionID
CZ: Συμπληρώνεται μόνο εάν η συναλλαγή εγκριθεί.
EL: Υπάρχει μόνο αν η συναλλαγή έχει διεκπεραιωθεί.
EL: Υπάρχει μόνο αν η συναλλαγή έχει διεκπεραιωθεί.
123456
authorizationCode
CZ: Μοναδικό αναγνωριστικό που παράγεται από την εφαρμογή πληρωμής κατά τη διαδικασία καταχώρισης της συναλλαγής.
EN: Μοναδικό αναγνωριστικό που παράγεται από την εφαρμογή πληρωμών κατά τη διαδικασία εγγραφής της συναλλαγής.
EN: Μοναδικό αναγνωριστικό που παράγεται από την εφαρμογή πληρωμών κατά τη διαδικασία εγγραφής της συναλλαγής.
001000000
pinOk
αληθές/ψευδές
cardNumber
CZ: Αριθμός κάρτας (PAN). Υπάρχει σε συγκαλυμμένη μορφή.
EL: Αριθμός κάρτας (PAN). Υπάρχει σε συγκαλυμμένη μορφή.
EL: Αριθμός κάρτας (PAN). Υπάρχει σε συγκαλυμμένη μορφή.
0001
ΚΩΔΙΚΟΣ
CZ: Εμφανίζει το αποτέλεσμα της συναλλαγής κατά την εξουσιοδότηση.
EL: Εμφανίζει το αποτέλεσμα της συναλλαγής στην πλευρά της εξουσιοδότησης.
EL: Εμφανίζει το αποτέλεσμα της συναλλαγής στην πλευρά της εξουσιοδότησης.
αποδεκτή