Η συναλλαγή πώλησης είναι μια βασική πράξη πληρωμής που μεταφέρει ένα συγκεκριμένο ποσό από τον τραπεζικό λογαριασμό του κατόχου της κάρτας στον λογαριασμό του εμπόρου.

Όσον αφορά τη διαδικασία πληρωμής, η διαδικασία έχει ως εξής:

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

Για όλα τα μη δημόσια τελικά σημεία απαιτείται έλεγχος ταυτότητας με 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

(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 με τις ακόλουθες πληροφορίες συμπληρωμένες για να δημιουργήσετε την αίτηση:

Περιεχόμενο της [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é:

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

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

Εάν θα δημιουργήσετε ή θα εκτυπώσετε την απόδειξη από την πλευρά σας, συνιστούμε να ελέγξετε ποια πεδία είναι υποχρεωτικά και πρέπει να εκτυπωθούν/εμφανιστούν στην απόδειξη. Μια περιγραφή είναι διαθέσιμη εδώ.