Τι ακριβώς είναι η δόση; Κάθε συναλλαγή που δημιουργείτε ανήκει σε μια δόση. Όπως μια απόδειξη, κάθε παρτίδα έχει έναν αριθμό και είναι στην πραγματικότητα ένα πακέτο συναλλαγών. Το κλείσιμο είναι μια διοικητική πράξη με την οποία το τερματικό κλείνει μια παρτίδα και προτρέπει τα συστήματα να κλείσουν τη παρτίδα και να ανοίξουν μια νέα. Στα συστήματα της Global Payments, είναι δυνατόν να δείτε τον αριθμό κλεισίματος για κάθε συναλλαγή και είναι δυνατόν να φιλτράρετε τις συναλλαγές με βάση αυτόν τον αριθμό.

Σύνδεση & πιστοποίηση ταυτότητας

Για όλα τα μη δημόσια τελικά σημεία απαιτείται έλεγχος ταυτότητας με token JWT. Το token (με διάρκεια ζωής 90 ημερών) λαμβάνεται μέσω του τελικού σημείου /cloud/oauth/token με τα ακόλουθα ορίσματα:

• Βασικός έλεγχος ταυτότητας για τερματικά σημεία token (όνομα/συνθηματικό) - θα παρέχεται για κάθε χρήστη.
• Όνομα χρήστη εμπόρου - το ίδιο όπως για το GP tom
• Κωδικός πρόσβασης εμπόρου - ο ίδιος όπως για το GP tom
• Terminal ID (TID) - ID του τερματικού σταθμού προορισμού
• Το τελικό σημείο εξουσιοδότησης βρίσκεται στη διεύθυνση:
  • dev: https://cloud-api-dev.gptom.com/cloud/oauth/token
  • Παραγωγή:https://cloud-api.gptom.com/cloud/oauth/token

Λήψη ενός κουπονιού πρόσβασης

Παράδειγμα αίτησης:

POST {{apiCloudHost}}/cloud/oauth/token
Authorization: Basic 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 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/BATCH και χρησιμοποιήστε το CreateCloudTaskTransactionApiRequest με τις ακόλουθες πληροφορίες συμπληρωμένες για τη δημιουργία της αίτησης:

Περιεχόμενο της [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 uzávěrka byla autorizována. Cílem tohoto kroku je získat stav uzávěrky a její údaje. Pro nový požadavek zavoláte koncový bod GET /v1/batches/{batchId}, kde použijete následující proměnné:

Οι πιθανοί κωδικοί απαντήσεων είναι:

Η απάντηση περιέχει τις ακόλουθες μεταβλητές ανάλογα με τον κωδικό απάντησης: