Η συναλλαγή πώλησης είναι μια βασική πράξη πληρωμής που μεταφέρει ένα συγκεκριμένο ποσό από τον τραπεζικό λογαριασμό του κατόχου της κάρτας στον λογαριασμό του εμπόρου.
Όσον αφορά τη διαδικασία πληρωμής, η διαδικασία έχει ως εξής:
Σύνδεση & πιστοποίηση ταυτότητας
Για όλα τα μη δημόσια τελικά σημεία απαιτείται έλεγχος ταυτότητας με token JWT. Το token (με διάρκεια ζωής 90 ημερών) λαμβάνεται μέσω του τελικού σημείου /cloud/oauth/token με τα ακόλουθα ορίσματα:
- Βασικός έλεγχος ταυτότητας για τερματικά σημεία token (όνομα/συνθηματικό) - θα παρέχεται για κάθε χρήστη.
- Όνομα χρήστη εμπόρου - το ίδιο όπως για το GP tom
- Κωδικός πρόσβασης εμπόρου - ο ίδιος όπως για το GP tom
- Terminal ID (TID) - ID του τερματικού σταθμού προορισμού
- Το τελικό σημείο εξουσιοδότησης βρίσκεται στη διεύθυνση:
Αυτή η μέθοδος ελέγχου ταυτότητας είναι η ίδια για όλα τα τερματικά.
Λήψη ενός κουπονιού πρόσβασης
Παράδειγμα αίτησης:
POST {{apiCloudHost}}/cloud/oauth/token
Authorization: Basic YXRvbTphc2hmdWY0ZTVmYQ==
Content-Type: application/x-www-form-urlencoded
(Authorization a Contect-Type je pro všechny zákazníky vždy stejný – použijte prosím stejné údaje jako v příkladu. Do grant_type je potřeba následně vložit unikátní údaje klienta).
grant_type=password&username=jan.novak@example.com&password=ABCDEFGHIJKL&tid=999888
Παράδειγμα απάντησης:
{ "access_token": "eyJh…", // access token used in authenticated API requests "token_type": "bearer", "refresh_token": "GciO…", "expires_in": 3600, "scope": "read write", "tid": "999888", }
Ανανέωση ενός κουπονιού
Όταν το access_token λήξει, είναι διαθέσιμο ένα refresh_token.
Παράδειγμα αίτησης:
POST {{apiHost}}/api/oauth/token
Authorization: Basic YXRvbTphc2hmdWY0ZTVmYQ==
Content-Type: application/x-www-form-urlencoded
grant_type=refresh_token&refresh_token=GciO…
GPTomAuth
Δημιουργία τσάντας
Καλέστε το τελικό σημείο POST /v1/tasks/TRANSACTION και χρησιμοποιήστε το CreateCloudTaskTransactionApiRequest με τις ακόλουθες πληροφορίες συμπληρωμένες για να δημιουργήσετε την αίτηση:
apiKey ΥΠΟΧΡΕΩΤΙΚΟ
tid ΕΝΤΟΛΕΣ
εκκινητής ΥΠΟΧΡΕΩΣΕΙΣ
τίτλος ΥΠΟΧΡΕΩΤΙΚΟ
Θα πρέπει να περιέχει κάποιο αναγνωριστικό στοιχείο της εργασίας. Παράδειγμα: "Τιμολόγιο 37364FD".
default: true Αληθές αν η απόδειξη πρέπει να εκτυπωθεί στη συσκευή. Σημείωση: Για κινητά τηλέφωνα, πρέπει να βεβαιωθείτε ότι ο εκτυπωτής Bluetooth είναι συνδεδεμένος.
ποσό ΥΠΟΧΡΕΩΤΙΚΟ
transactionOperation ΥΠΟΧΡΕΩΤΙΚΟ
Λειτουργία ακύρωσης, όχι null εάν ο τύπος συναλλαγής είναι VOID Πιθανές τιμές: [ LAST_TRANSACTION, OLDER_TRANSACTION ]
transactionType* ΥΠΟΧΡΕΩΤΙΚΟ
default: false Αν οριστεί σε true, θα κληθεί πρώτα η οθόνη καταχώρησης φιλοδωρήματος στο GP tom. Για να κληθεί αυτή η οθόνη, πρέπει επίσης να έχετε ενεργοποιήσει το φιλοδώρημα στην εφαρμογή.
Περιεχόμενο της [CloudTaskDetailApiResponse]:
Οι πιθανοί κωδικοί απαντήσεων είναι:
Ακολουθούν οι μεταβλητές που χρησιμοποιήθηκαν στην απάντηση:
Ελέγξτε την κατάσταση της τσάντας
V dalším kroku budete kontrolovat stav tasku na koncovém bodu GET /v1/tasks/{taskID} pomocí požadavku, který zahrnuje:
Πιθανοί κωδικοί επιστροφής:
Μεταβλητές απόκρισης:
Το αίτημα για την κατάσταση του σάκου θα πρέπει να επαναλαμβάνεται μέχρι να λάβετε έναν από τους τελικούς κωδικούς απάντησης, οι οποίοι είναι:
Μπορείτε να προχωρήσετε στο επόμενο βήμα μόνο εάν η απάντηση βρίσκεται στην κατάσταση ΟΛΟΚΛΗΡΩΜΕΝΟ.
Λήψη του αποτελέσματος πληρωμής
Nyní víme, že transakce byla autorizována. Cílem tohoto kroku je získat stav transakce a detaily transakce. Pro nový požadavek zavoláte koncový bod GET /v1/transactions/{transactionId}, kde použijete následující proměnné:
Οι πιθανοί κωδικοί απαντήσεων είναι:
Η απάντηση περιέχει τις ακόλουθες μεταβλητές ανάλογα με τον κωδικό απάντησης:
Αποτέλεσμα συναλλαγής, πιθανές τιμές [ ACCEPTED, DECLINED, CANCELLED ] όπου: ACCEPTED - η συναλλαγή εγκρίθηκε επιτυχώς DECLINED - η συναλλαγή απορρίφθηκε για κάποιο λόγο CANCELLED - αν η συναλλαγή ακυρώθηκε από τον χειριστή ή τον πελάτη.
Πιθανές τιμές: ""ΠΩΛΗΣΗ"" ""ΑΚΥΡΩΣΗ"" ""ΕΠΙΣΤΡΟΦΗ"" Τύπος λειτουργίας / συναλλαγής."
Εάν θα δημιουργήσετε ή θα εκτυπώσετε την απόδειξη από την πλευρά σας, συνιστούμε να ελέγξετε ποια πεδία είναι υποχρεωτικά και πρέπει να εκτυπωθούν/εμφανιστούν στην απόδειξη. Μια περιγραφή είναι διαθέσιμη εδώ.