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

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

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

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} χρησιμοποιώντας τις ακόλουθες μεταβλητές:

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

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

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