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

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

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

Για όλα τα μη δημόσια τελικά σημεία απαιτείται έλεγχος ταυτότητας με 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
Εξουσιοδότηση: Βασικό YXRvbTphc2hmdWY0ZTVmYQ==
Content-Type: application/x-www-form-urlencoded

(Η εξουσιοδότηση και το Contect-Type είναι πάντα τα ίδια για όλους τους πελάτες - παρακαλούμε χρησιμοποιήστε τα ίδια δεδομένα όπως στο παράδειγμα. Πρέπει να εισαγάγετε τα μοναδικά δεδομένα του πελάτη στο grant_type στη συνέχεια).

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

Περιεχόμενο της [CloudTaskDetailApiResponse]:

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

Ακολουθούν οι μεταβλητές που χρησιμοποιήθηκαν στην απάντηση:

Ελέγξτε την κατάσταση της τσάντας

Στο επόμενο βήμα, θα ελέγξετε την κατάσταση της εργασίας στο τελικό σημείο GET /v1/tasks/{taskID} χρησιμοποιώντας μια αίτηση που περιλαμβάνει:

Πιθανοί κωδικοί επιστροφής:

Μεταβλητές απόκρισης:

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

Μπορείτε να προχωρήσετε στο επόμενο βήμα μόνο εάν η απάντηση βρίσκεται στην κατάσταση ΟΛΟΚΛΗΡΩΜΕΝΟ.

Λήψη του αποτελέσματος πληρωμής

Γνωρίζουμε τώρα ότι η συναλλαγή έχει εγκριθεί. Ο στόχος αυτού του βήματος είναι να λάβουμε την κατάσταση της συναλλαγής και τις λεπτομέρειες της συναλλαγής. Για τη νέα αίτηση, θα καλέσετε το τελικό σημείο GET /v1/transactions/{transactionId} χρησιμοποιώντας τις ακόλουθες μεταβλητές:

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

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

Pokud budete účtenku generovat nebo tisknout na své straně, doporučujeme zkontrolovat, která pole jsou povinná a musí být vytištěna/zobrazena na účtence. Popis je k dispozici zde.