Η συναλλαγή πώλησης είναι μια βασική πράξη πληρωμής που μεταφέρει ένα συγκεκριμένο ποσό από τον τραπεζικό λογαριασμό του κατόχου της κάρτας στον λογαριασμό του εμπόρου.
Όσον αφορά τη διαδικασία πληρωμής, η διαδικασία έχει ως εξής:
Δημιουργία συναλλαγής
Η συναλλαγή μπορεί να ξεκινήσει καλώντας:
gptom://transaction/create?…
όπου χρησιμοποιούνται οι ακόλουθες παράμετροι για τη δημιουργία της έκθεσης:
Μεταβλητή/πεδίο
Μορφή/Φορμά
Περιγραφή/Περιγραφή
Παράδειγμα
ποσό
ΥΠΟΧΡΕΩΤΙΚΟ
ΥΠΟΧΡΕΩΤΙΚΟ
μακρύ
CZ: Ποσό συναλλαγής με δύο δεκαδικά ψηφία.
EL: Ποσό συναλλαγής με δύο δεκαδικά ψηφία.
EL: Ποσό συναλλαγής με δύο δεκαδικά ψηφία.
1000 (=10CZK/ΕΥΡΏ)
clientID
string
CZ: Προαιρετικός έλεγχος του συνδεδεμένου χρήστη. Εδώ ελέγχεται το κλειδί API του τερματικού.
EN: Προαιρετικός έλεγχος του συνδεδεμένου χρήστη. Εδώ ελέγχεται το κλειδί API του τερματικού.
EN: Προαιρετικός έλεγχος του συνδεδεμένου χρήστη. Εδώ ελέγχεται το κλειδί API του τερματικού.
originReferenceNum
string
CZ: Αριθμός αναφοράς έως 20 χαρακτήρες - κατάλληλος για αριθμό τιμολογίου, πληρωμή - μπορεί να χρησιμοποιηθεί για την αντιστοίχιση της πληρωμής σας με τις πωλήσεις ή τις παραγγελίες.
Αριθμός αναφοράς έως 20 χαρακτήρες – κατάλληλος για αριθμό τιμολογίου, πληρωμή – μπορεί να χρησιμοποιηθεί για την αντιστοίχιση των πληρωμών με τις πωλήσεις ή τις παραγγελίες.
Αριθμός αναφοράς έως 20 χαρακτήρες – κατάλληλος για αριθμό τιμολογίου, πληρωμή – μπορεί να χρησιμοποιηθεί για την αντιστοίχιση των πληρωμών με τις πωλήσεις ή τις παραγγελίες.
printByPaymentApp
bool
CZ: Καθορίζει αν η απόδειξη διαβιβάζεται στον πελάτη από την εφαρμογή σας ή από την GP tom. Η προεπιλεγμένη τιμή είναι true (δηλαδή το GP tom θα προσφέρει τη μέθοδο διαβίβασης της απόδειξης στον πελάτη). Εάν στείλετε την τιμή “false”, θα επιστρέψουμε τον χρήστη στην εφαρμογή σας αμέσως μετά τη συναλλαγή και εναπόκειται σε εσάς να περάσετε την απόδειξη.
Καθορίζει αν η απόδειξη διαβιβάζεται στον πελάτη από την εφαρμογή σας ή από το GP. Η προεπιλεγμένη τιμή είναι "true" (δηλ. το GP θα προσφέρει έναν τρόπο διαβίβασης της απόδειξης στον πελάτη). Εάν στείλετε την τιμή "false", επιστρέφουμε τον χρήστη στην εφαρμογή σας αμέσως μετά τη συναλλαγή και εναπόκειται σε εσάς να διαβιβάσετε την απόδειξη.
Καθορίζει αν η απόδειξη διαβιβάζεται στον πελάτη από την εφαρμογή σας ή από το GP. Η προεπιλεγμένη τιμή είναι "true" (δηλ. το GP θα προσφέρει έναν τρόπο διαβίβασης της απόδειξης στον πελάτη). Εάν στείλετε την τιμή "false", επιστρέφουμε τον χρήστη στην εφαρμογή σας αμέσως μετά τη συναλλαγή και εναπόκειται σε εσάς να διαβιβάσετε την απόδειξη.
αληθές/ψευδές
TipAmount
μακρύ
CZ: Στα εστιατόρια μπορείτε να ζητήσετε από τον πελάτη να προσθέσει φιλοδώρημα, το οποίο καταχωρείται στο σύστημά σας. Το ποσό αυτό προστίθεται στη συνέχεια στο αρχικό ποσό που έχει καταχωρήσει ο πωλητής.
EN: Στα εστιατόρια, μπορείτε να ζητήσετε από τον πελάτη να προσθέσει φιλοδώρημα, το οποίο καταχωρείται στο σύστημά σας. Το ποσό αυτό προστίθεται στη συνέχεια στο αρχικό ποσό που έχει καταχωρήσει ο έμπορος.
EN: Στα εστιατόρια, μπορείτε να ζητήσετε από τον πελάτη να προσθέσει φιλοδώρημα, το οποίο καταχωρείται στο σύστημά σας. Το ποσό αυτό προστίθεται στη συνέχεια στο αρχικό ποσό που έχει καταχωρήσει ο έμπορος.
1000 (=10CZK/ΕΥΡΏ)
redirectUrl
string
CZ: Η διεύθυνση URL της εφαρμογής σας, στην οποία θα ανακατευθύνουμε τον πελάτη μετά την ολοκλήρωση της πληρωμής.
EN: Η διεύθυνση URL της εφαρμογής σας, στην οποία θα ανακατευθύνουμε τον πελάτη μετά την ολοκλήρωση της πληρωμής.
EN: Η διεύθυνση URL της εφαρμογής σας, στην οποία θα ανακατευθύνουμε τον πελάτη μετά την ολοκλήρωση της πληρωμής.
fb://success
TipCollect
bool
CZ: Προαιρετικό πεδίο που εμφανίζει την οθόνη εισαγωγής φιλοδωρήματος στην εφαρμογή GP tom. Αφού εισαχθεί το φιλοδώρημα στην εφαρμογή, εμφανίζεται στη συνέχεια η οθόνη για την τοποθέτηση της κάρτας. Για να εμφανιστεί αυτή η οθόνη, πρέπει επίσης να είναι ενεργοποιημένη η λειτουργία φιλοδωρήματος στην εφαρμογή.
EN: Ένα προαιρετικό πεδίο που ανοίγει την οθόνη εισαγωγής φιλοδωρήματος στην εφαρμογή GP tom. Αφού εισαγάγετε το φιλοδώρημα στην εφαρμογή, θα εμφανιστεί μια οθόνη για την προσάρτηση της κάρτας. Για να εμφανιστεί αυτή η οθόνη, πρέπει επίσης να έχετε ενεργοποιήσει τη λειτουργία φιλοδωρήματος στην εφαρμογή.
EN: Ένα προαιρετικό πεδίο που ανοίγει την οθόνη εισαγωγής φιλοδωρήματος στην εφαρμογή GP tom. Αφού εισαγάγετε το φιλοδώρημα στην εφαρμογή, θα εμφανιστεί μια οθόνη για την προσάρτηση της κάρτας. Για να εμφανιστεί αυτή η οθόνη, πρέπει επίσης να έχετε ενεργοποιήσει τη λειτουργία φιλοδωρήματος στην εφαρμογή.
αληθές / ψευδές
preferableReceiptType
enum (sms,email,qr,print)
CZ: Σε περίπτωση αποστολής απόδειξης από την εφαρμογή GP tom, είναι δυνατόν να προκαθορίσετε τη μέθοδο αποστολής της απόδειξης μέσω API. Πιθανές τιμές είναι οι εξής:
EL: Στην περίπτωση αποστολής απόδειξης από την εφαρμογή GP tom, είναι δυνατόν να προκαθορίσετε τη μέθοδο αποστολής της απόδειξης μέσω του API. Οι πιθανές τιμές είναι οι εξής: 1:
ΤΗΛΕΦΩΝΟ
EMAIL
QR
ΕΚΤΥΠΩΣΗ
EL: Στην περίπτωση αποστολής απόδειξης από την εφαρμογή GP tom, είναι δυνατόν να προκαθορίσετε τη μέθοδο αποστολής της απόδειξης μέσω του API. Οι πιθανές τιμές είναι οι εξής: 1:
ΤΗΛΕΦΩΝΟ
QR
ΕΚΤΥΠΩΣΗ
κείμενο
clientPhone
string
CZ: Αριθμός τηλεφώνου του πελάτη.
EL: Αριθμός τηλεφώνου πελάτη.
EL: Αριθμός τηλεφώνου πελάτη.
+420606505404
clientEmail
string
CZ: Διεύθυνση ηλεκτρονικού ταχυδρομείου του πελάτη.
EL: Διεύθυνση ηλεκτρονικού ταχυδρομείου του πελάτη.
EL: Διεύθυνση ηλεκτρονικού ταχυδρομείου του πελάτη.
info@gptom.com
transactionType
string
CZ: Ο τύπος συναλλαγής καθορίζει τον τύπο της συναλλαγής που θέλετε να ξεκινήσετε. Οι διαθέσιμες τιμές είναι:
EN:Ο τύπος συναλλαγής καθορίζει τον τύπο της συναλλαγής που θέλετε να ξεκινήσετε. Οι διαθέσιμες τιμές είναι:
CASH
ΚΑΡΤΑ
ACCOUNT_PAYMENT
BLIK_PAYMENT
PAYMENT_GATEWAY
EN:Ο τύπος συναλλαγής καθορίζει τον τύπο της συναλλαγής που θέλετε να ξεκινήσετε. Οι διαθέσιμες τιμές είναι:
CASH
ΚΑΡΤΑ
ACCOUNT_PAYMENT
BLIK_PAYMENT
PAYMENT_GATEWAY
ΚΑΡΤΑ
Παράδειγμα κλήσης:
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
Η απάντηση θα περιέχει τα ακόλουθα πεδία:
Πεδίο/Πεδίο
Μορφή
Περιγραφή/Περιγραφή
Παράδειγμα/Παράδειγμα
ΚΑΤΑΣΤΑΣΗ ΕΡΓΑΣΙΑΣ
CZ: Δίνει πληροφορίες σχετικά με την κατάσταση στην οποία ολοκληρώθηκε η συγκεκριμένη αίτηση
EL: Παρέχει πληροφορίες για το κράτος στο οποίο έληξε η αίτησή σας.
EL: Παρέχει πληροφορίες για το κράτος στο οποίο έληξε η αίτησή σας.
ΟΛΟΚΛΗΡΩΜΕΝΟ
ΑΚΥΡΩΘΗΚΕ
ΣΦΑΛΜΑ
ΑΚΥΡΩΘΗΚΕ
ΣΦΑΛΜΑ
terminalID
CZ: ID του τερματικού στο οποίο υποβάλλονται σε επεξεργασία οι συναλλαγές. Προσδιορίζει το τερματικό στα συστήματα GP.
EL: Μοναδικό αναγνωριστικό τερματικού, με το οποίο επεξεργάζεται η συναλλαγή.
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
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: Μοναδικό αναγνωριστικό εμπόρου, συνήθως αναγνωριστικό τοποθεσίας
EL: Μοναδικό αναγνωριστικό εμπόρου, συνήθως αναγνωριστικό τοποθεσίας
TipAmount
CZ: Συμβουλές. Συμπληρώνεται εάν έχει καταχωρηθεί.
EN: Συμβουλή. Συμπληρώνεται αν χρειαστεί.
EN: Συμβουλή. Συμπληρώνεται αν χρειαστεί.
2
totalAmount
CZ: Αναφέρει το συνολικό ποσό της συναλλαγής (συμπεριλαμβανομένου του φιλοδωρήματος)
EL: Δείχνει το συνολικό ποσό της συναλλαγής (συμπεριλαμβανομένου του φιλοδωρήματος)
EL: Δείχνει το συνολικό ποσό της συναλλαγής (συμπεριλαμβανομένου του φιλοδωρήματος)
12
αποτέλεσμα
CZ: Απάντηση στο αίτημα.
EL: Αποτέλεσμα του αιτήματος.
EL: Αποτέλεσμα του αιτήματος.
0 - εγκεκριμένη συναλλαγή
-1 - απορριφθείσα συναλλαγή
-1 - απορριφθείσα συναλλαγή
cardEntryMode
CZ: Προσδιορίζει τη μέθοδο εισαγωγής των δεδομένων της κάρτας, όπως chip, ανέπαφη κάρτα, μαγνητική λωρίδα κ.λπ.
EL: Καθορίζει τον τρόπο ανάγνωσης της κάρτας: μαγνητική λωρίδα, τσιπ ή ανέπαφη κάρτα.
EL: Καθορίζει τον τρόπο ανάγνωσης της κάρτας: μαγνητική λωρίδα, τσιπ ή ανέπαφη κάρτα.
CONTACTLESS
transactionID
CZ: Συμπληρώνεται μόνο εάν η συναλλαγή εγκριθεί.
EL: Υπάρχει μόνο αν η συναλλαγή έχει διεκπεραιωθεί.
EL: Υπάρχει μόνο αν η συναλλαγή έχει διεκπεραιωθεί.
123456
authorizationCode
CZ: Μοναδικό αναγνωριστικό που παράγεται από την εφαρμογή πληρωμής κατά τη διαδικασία καταχώρισης της συναλλαγής.
EL: Μοναδικό αναγνωριστικό που δημιουργείται από την εφαρμογή πληρωμής κατά τη διαδικασία εγγραφής της συναλλαγής.
EL: Μοναδικό αναγνωριστικό που δημιουργείται από την εφαρμογή πληρωμής κατά τη διαδικασία εγγραφής της συναλλαγής.
001000000
pinOk
αληθές/ψευδές
cardNumber
CZ: Αριθμός κάρτας (PAN). Υπάρχει σε συγκαλυμμένη μορφή.
EL: Αριθμός κάρτας (PAN). Υπάρχει σε συγκαλυμμένη μορφή.
EL: Αριθμός κάρτας (PAN). Υπάρχει σε συγκαλυμμένη μορφή.
0001
ΚΩΔΙΚΟΣ
CZ: Εμφανίζει το αποτέλεσμα της συναλλαγής κατά την εξουσιοδότηση.
EL: Εμφανίζει το αποτέλεσμα της συναλλαγής στην πλευρά της εξουσιοδότησης.
EL: Εμφανίζει το αποτέλεσμα της συναλλαγής στην πλευρά της εξουσιοδότησης.
αποδεχθεί