Τι ακριβώς είναι η δόση; Κάθε συναλλαγή που δημιουργείτε ανήκει σε μια δόση. Όπως μια απόδειξη, κάθε παρτίδα έχει έναν αριθμό και είναι στην πραγματικότητα ένα πακέτο συναλλαγών. Το κλείσιμο είναι μια διοικητική πράξη με την οποία το τερματικό κλείνει μια παρτίδα και προτρέπει τα συστήματα να κλείσουν τη παρτίδα και να ανοίξουν μια νέα. Στα συστήματα της Global Payments, είναι δυνατόν να δείτε τον αριθμό κλεισίματος για κάθε συναλλαγή και είναι δυνατόν να φιλτράρετε τις συναλλαγές με βάση αυτόν τον αριθμό.
Σύνδεση & πιστοποίηση ταυτότητας
Για όλα τα μη δημόσια τελικά σημεία απαιτείται έλεγχος ταυτότητας με token JWT. Το token (με διάρκεια ζωής 90 ημερών) λαμβάνεται μέσω του τελικού σημείου /cloud/oauth/token με τα ακόλουθα ορίσματα:
- Βασικός έλεγχος ταυτότητας για τερματικά σημεία token (όνομα/συνθηματικό) - θα παρέχεται για κάθε χρήστη.
- Όνομα χρήστη εμπόρου - το ίδιο όπως για το GP tom
- Κωδικός πρόσβασης εμπόρου - ο ίδιος όπως για το GP tom
- Terminal ID (TID) - ID του τερματικού σταθμού προορισμού
- Το τελικό σημείο εξουσιοδότησης βρίσκεται στη διεύθυνση:
Λήψη ενός κουπονιού πρόσβασης
Παράδειγμα αίτησης:
POST {{apiCloudHost}}/cloud/oauth/token
Εξουσιοδότηση: Βασικό YXRvbTphc2hmdWY0ZTVmYQ==
Content-Type: application/x-www-form-urlencoded
grant_type=password&username=jan.novak@example.com&password=ABCDEFGHIJKL&tid=999888
Παράδειγμα απάντησης:
{
"access_token": "eyJh...", // access token που χρησιμοποιείται σε πιστοποιημένα αιτήματα API
"token_type": "bearer",
"refresh_token": "GciO...",
"expires_in": 3600,
"scope": "read write",
"tid": "999888",
}Ανανέωση ενός κουπονιού
Όταν το access_token λήξει, είναι διαθέσιμο ένα refresh_token.
Παράδειγμα αίτησης:
POST {{apiHost}}/api/oauth/token
Εξουσιοδότηση: Βασικό YXRvbTphc2hmdWY0ZTVmYQ==
Content-Type: application/x-www-form-urlencoded
grant_type=refresh_token&refresh_token=GciO...
GPTomAuth
Δημιουργία τσάντας
Καλέστε το τελικό σημείο POST /v1/tasks/BATCH και χρησιμοποιήστε το CreateCloudTaskTransactionApiRequest με τις ακόλουθες πληροφορίες συμπληρωμένες για τη δημιουργία της αίτησης:
ΥΠΟΧΡΕΩΤΙΚΟ
ΥΠΟΧΡΕΩΤΙΚΟ
ΥΠΟΧΡΕΩΤΙΚΟ
ΥΠΟΧΡΕΩΤΙΚΟ
ΥΠΟΧΡΕΩΤΙΚΟ
Παράδειγμα: „Τιμολόγιο 37364FD“
Περιεχόμενο της [CloudTaskDetailApiResponse]:
Οι πιθανοί κωδικοί απαντήσεων είναι:
Ακολουθούν οι μεταβλητές που χρησιμοποιήθηκαν στην απάντηση:
Ελέγξτε την κατάσταση της τσάντας
Στο επόμενο βήμα, θα ελέγξετε την κατάσταση της εργασίας στο τελικό σημείο GET /v1/tasks/{taskID} χρησιμοποιώντας μια αίτηση που περιλαμβάνει:
Πιθανοί κωδικοί επιστροφής:
Μεταβλητές απόκρισης:
Το αίτημα για την κατάσταση του σάκου θα πρέπει να επαναλαμβάνεται μέχρι να λάβετε έναν από τους τελικούς κωδικούς απάντησης, οι οποίοι είναι:
Μπορείτε να προχωρήσετε στο επόμενο βήμα μόνο εάν η απάντηση βρίσκεται στην κατάσταση ΟΛΟΚΛΗΡΩΜΕΝΟ.
Αποκτώντας το αποτέλεσμα κλεισίματος
Γνωρίζουμε τώρα ότι το κλείσιμο έχει εγκριθεί. Στόχος αυτού του βήματος είναι να λάβουμε την κατάσταση της προθεσμίας και των δεδομένων της. Για τη νέα αίτηση, καλείτε το τελικό σημείο GET /v1/batches/{batchId} χρησιμοποιώντας τις ακόλουθες μεταβλητές:
Οι πιθανοί κωδικοί απαντήσεων είναι:
Η απάντηση περιέχει τις ακόλουθες μεταβλητές ανάλογα με τον κωδικό απάντησης:
-closeBatchNumber (string) - closeBatchNumber podřízené dávky
- totalCount (number) - Celkový počet transakcí v dávce
- saleCount (number) - Počet transakcí typu prodej v dávce
- saleAmount (number) - Objem transakcí typu prodej v dávce
- voidCount (number) - Počet storen transakcí
- voidAmount (number) - Objem storen transakcí v dávce