Η πράξη ακύρωσης είναι μία από τις βασικές πράξεις πληρωμής, η οποία εξασφαλίζει την ακύρωση της πράξης πληρωμής που έχει ήδη πραγματοποιηθεί πίσω στο λογαριασμό του κατόχου της κάρτας.
Η διαδικασία ακύρωσης έχει ως εξής:
Δημιουργία μιας ακύρωσης
Η συναλλαγή μπορεί να ξεκινήσει καλώντας:
gptom://transaction/cancel?…
όπου χρησιμοποιούνται οι ακόλουθες παράμετροι για τη δημιουργία της έκθεσης, συμπεριλαμβανομένου του amsID που αντιστοιχίζεται σε κάθε πληρωμή:
Μεταβλητή/πεδίο
Μορφή/μορφή
Περιγραφή/Περιγραφή
Παράδειγμα
clientID
string
amsID ΥΠΟΧΡΕΩΤΙΚΟ
string
CZ: Μοναδικό amsID που θα λάβετε κατά τη στιγμή της πληρωμής.
EL: Το μοναδικό amsID που θα λάβετε κατά την πληρωμή.
EL: Το μοναδικό amsID που θα λάβετε κατά την πληρωμή.
redirectUrl
string
CZ: URL της εφαρμογής σας στην οποία ανακατευθύνουμε τον πελάτη μετά την ολοκλήρωση της ακύρωσης.
EN: Η διεύθυνση URL της εφαρμογής σας στην οποία θα ανακατευθύνουμε τον πελάτη μετά την ολοκλήρωση της ακύρωσης.
EN: Η διεύθυνση URL της εφαρμογής σας στην οποία θα ανακατευθύνουμε τον πελάτη μετά την ολοκλήρωση της ακύρωσης.
fb://Success
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
κείμενο
printByPaymentApp
bool
CZ: Καθορίζει αν η απόδειξη διαβιβάζεται στον πελάτη από την εφαρμογή σας ή από την GP tom. Η προεπιλεγμένη τιμή είναι true (δηλαδή το GP tom θα προσφέρει τη μέθοδο διαβίβασης της απόδειξης στον πελάτη). Εάν στείλετε την τιμή "false", θα επιστρέψουμε τον χρήστη στην εφαρμογή σας αμέσως μετά τη συναλλαγή και εναπόκειται σε εσάς να περάσετε την απόδειξη.
EL: Καθορίζει εάν η απόδειξη διαβιβάζεται στον πελάτη από την εφαρμογή σας ή από την GP tom. Η προεπιλεγμένη τιμή είναι true (δηλ. το GP θα προσφέρει έναν τρόπο να περάσει την απόδειξη στον πελάτη). Εάν στείλετε την τιμή "false", επιστρέφουμε τον χρήστη στην εφαρμογή σας αμέσως μετά τη συναλλαγή και εναπόκειται σε εσάς να περάσετε την απόδειξη.
EL: Καθορίζει εάν η απόδειξη διαβιβάζεται στον πελάτη από την εφαρμογή σας ή από την GP tom. Η προεπιλεγμένη τιμή είναι true (δηλ. το GP θα προσφέρει έναν τρόπο να περάσει την απόδειξη στον πελάτη). Εάν στείλετε την τιμή "false", επιστρέφουμε τον χρήστη στην εφαρμογή σας αμέσως μετά τη συναλλαγή και εναπόκειται σε εσάς να περάσετε την απόδειξη.
αληθές/ψευδές
clientPhone
string
CZ: Αριθμός τηλεφώνου του πελάτη.
EL: Αριθμός τηλεφώνου πελάτη.
EL: Αριθμός τηλεφώνου πελάτη.
+420606505404
clientEmail
string
CZ: Διεύθυνση ηλεκτρονικού ταχυδρομείου του πελάτη.
EL: Διεύθυνση ηλεκτρονικού ταχυδρομείου του πελάτη.
EL: Διεύθυνση ηλεκτρονικού ταχυδρομείου του πελάτη.
info@gptom.com
Παράδειγμα κλήσης:
gptom://transaction/cancel?amsID=123&preferableReceiptType=QR&clientPhone=+420606505404&clientID=123&printByPaymentApp=true&redirectUrl=gp://transaction/cancel&clientEmail=info@gptom.com
Η απάντηση θα περιέχει τα ακόλουθα πεδία:
Πεδίο/Πεδίο
Περιγραφή/Περιγραφή
Παράδειγμα/Παράδειγμα
ΚΑΤΑΣΤΑΣΗ ΕΡΓΑΣΙΑΣ
CZ: Δίνει την απάντηση σε ποια κατάσταση έληξε η αίτηση.
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: Μοναδικός αριθμός συναλλαγής.
referenceNumber
CZ: Αριθμός αναφοράς που αναγράφεται κατά την αίτηση πληρωμής.
EL: Αριθμός αναφοράς που αναγράφεται κατά την αίτηση πληρωμής
EL: Αριθμός αναφοράς που αναγράφεται κατά την αίτηση πληρωμής
ABC123
sequenceNumber
CZ: Χρησιμοποιείται για συναλλαγές ακύρωσης. Χρησιμοποιήστε τη ληφθείσα αξία που ήταν μέρος της συναλλαγής που θέλετε να ακυρώσετε.
EL: Χρησιμοποιείται για την ακύρωση συναλλαγών. Χρησιμοποιείται η ληφθείσα τιμή που αποτελούσε μέρος της συναλλαγής που θέλετε να ακυρώσετε.
EL: Χρησιμοποιείται για την ακύρωση συναλλαγών. Χρησιμοποιείται η ληφθείσα τιμή που αποτελούσε μέρος της συναλλαγής που θέλετε να ακυρώσετε.
001000000
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: Μοναδικό αναγνωριστικό που παράγεται από την εφαρμογή πληρωμής κατά τη διαδικασία καταχώρισης της συναλλαγής.
EN: Μοναδικό αναγνωριστικό που παράγεται από την εφαρμογή πληρωμών κατά τη διαδικασία εγγραφής της συναλλαγής.
EN: Μοναδικό αναγνωριστικό που παράγεται από την εφαρμογή πληρωμών κατά τη διαδικασία εγγραφής της συναλλαγής.
001000000
authorizationCode
CZ: Συμπληρώνεται μόνο εάν η συναλλαγή εγκριθεί.
EL: Υπάρχει μόνο αν η συναλλαγή έχει διεκπεραιωθεί.
EL: Υπάρχει μόνο αν η συναλλαγή έχει διεκπεραιωθεί.
123456
cardNumber
CZ: Αριθμός κάρτας (PAN). Υπάρχει σε συγκαλυμμένη μορφή.
EL: Αριθμός κάρτας (PAN). Υπάρχει σε συγκαλυμμένη μορφή.
EL: Αριθμός κάρτας (PAN). Υπάρχει σε συγκαλυμμένη μορφή.
0001
pinOk
αληθές/ψευδές
ΚΩΔΙΚΟΣ
CZ: Εμφανίζει το αποτέλεσμα της συναλλαγής κατά την εξουσιοδότηση.
EL: Εμφανίζει το αποτέλεσμα της συναλλαγής στην πλευρά της εξουσιοδότησης.
EL: Εμφανίζει το αποτέλεσμα της συναλλαγής στην πλευρά της εξουσιοδότησης.
εγκεκριμένο