Από την έκδοση της εφαρμογής 1.15 και μετά, μπορείτε να πραγματοποιείτε είσοδο και έξοδο από την εφαρμογή απευθείας μέσω του δικού σας συστήματος, χρησιμοποιώντας το API deeplink. Αυτή η δυνατότητα άμεσης σύνδεσης/αποσύνδεσης μέσω API καταργεί την ανάγκη το προσωπικό να μεταβαίνει στην αυτόνομη εφαρμογή GP tom και να εισάγει χειροκίνητα τα διαπιστευτήρια — πλέον μπορείτε να διαχειρίζεστε ολόκληρη τη διαδικασία μέσα από τη δική σας εφαρμογή. Έτσι, μειώνεται ο χρόνος που απαιτείται για την ενεργοποίηση του τερματικού, περιορίζονται τα αιτήματα υποστήριξης που σχετίζονται με τη σύνδεση και —το σημαντικότερο— απλοποιούνται οι ροές εργασίας που περιλαμβάνουν συχνές εναλλαγές προσωπικού ή συσκευών (όπως σε βάρδιες στον κλάδο της φιλοξενίας ή του λιανεμπορίου, ή σε περιπτώσεις διανομέων που μοιράζονται τερματικά μεταξύ των βαρδιών τους).
Σύνδεση στην εφαρμογή
Αίτημα
Διαδρομή deeplink: gptom://login
Παράδειγμα κλήσης:
gptom://login?
username=merchant%40example.com&
password=ισχυρός κωδικός πρόσβασης&
tid=123456&
redirectUrl=gp%3A%2F%2Flogin
Εάν η κατάσταση ERROR επιστρέφει error=passwordChangeRequired, αυτό υποδεικνύει την πρώτη σύνδεση του χρήστη και πρέπει να ακολουθηθεί η διαδικασία που περιγράφεται παρακάτω.
Πρώτη σύνδεση στην εφαρμογή με αλλαγή κωδικού πρόσβασης
Εάν ο χρήστης δεν έχει ορίσει ακόμη κωδικό πρόσβασης για τη σύνδεση μέσω deeplink (σύνδεση για πρώτη φορά), το αίτημα σύνδεσης επιστρέφει το σφάλμα `passwordChangeRequired`. Σε αυτή την περίπτωση, είναι απαραίτητο να αποσταλεί ένα deeplink τύπου `change-password` σε δύο βήματα.
Αίτημα
Διαδρομή deeplink: gptom://change-password
Βήμα 1 – χωρίς αίτημα για κωδικό επαλήθευσης
Μια κλήση χωρίς την παράμετρο Code. Σε περίπτωση επιτυχίας (status=COMPLETED, χωρίς σφάλμα), το σύστημα αποστέλλει έναν κωδικό επαλήθευσης στο email του χρήστη.
gptom://change-password?
username=merchant%40example.com&
password=ισχυρός κωδικός πρόσβασης&
newPassword=ΝέοςΙσχυρόςΚωδικόςΠρόσβασης1&
tid=123456&
redirectURL=gp%3A%2F%2Fchange-password
Βήμα 2 – Επιβεβαίωση μέσω κωδικού
Η ίδια κλήση, συμπεριλαμβανομένης της παραμέτρου code που στάλθηκε μέσω email. Σε περίπτωση επιτυχίας, ο κωδικός πρόσβασης αλλάζει και μπορείτε να προχωρήσετε σε μια τυπική διαδικασία σύνδεσης.
gptom://change-password?
username=merchant%40example.com&
password=ισχυρός κωδικός πρόσβασης&
newPassword=ΝέοςΙσχυρόςΚωδικόςΠρόσβασης1&
tid=123456&
code=AsfweWW41515&
redirectURL=gp%3A%2F%2Fchange-password
Αποσύνδεση από την εφαρμογή
Αίτημα
Διαδρομή deeplink: gptom://logout
gp://logout?redirectUrl=gp%3A%2F%2Flogout
Κωδικοί κατάστασης
EN: Η αίτηση ολοκληρώθηκε με επιτυχία.
EN: Η αίτηση απέτυχε — ανατρέξτε στην παράμετρο σφάλματος για λεπτομέρειες.
EN: Ο χρήστης ακύρωσε το αίτημα μέσα στην εφαρμογή GP tom.
Κωδικοί σφάλματος που σχετίζονται με τη σύνδεση/αποσύνδεση
EN: Μη έγκυρο όνομα χρήστη ή κωδικός πρόσβασης.
EN: Ο TID που παρέχεται δεν έχει εκχωρηθεί σε αυτόν τον χρήστη.
EN: Ο TID που δόθηκε χρησιμοποιείται ήδη από άλλον χρήστη.
EN: Ο ίδιος χρήστης έχει ήδη συνδεθεί σε αυτή τη συσκευή με διαφορετικό TID.
EN: Πρώτη σύνδεση – πρέπει πρώτα να ορίσετε τον κωδικό πρόσβασης.
EN: Αυτό συμβαίνει κατά την πρώτη σύνδεση μετά το βήμα 1, όταν αποστέλλεται ένας κωδικός εξουσιοδότησης μέσω ηλεκτρονικού ταχυδρομείου.
EN: Ο κωδικός επιβεβαίωσης που δόθηκε για την αλλαγή του κωδικού πρόσβασης δεν είναι έγκυρος.
EN: Δεν ήταν δυνατή η σύνδεση του χρήστη.
EN: Αποστέλλονται λανθασμένα διαπιστευτήρια.
EN: Η ρύθμιση του τερματικού απέτυχε. Παρακαλούμε επικοινωνήστε με την υποστήριξη μας.
Επαλήθευση κατάστασης σύνδεσης
Για να διαπιστώσετε εάν ο χρήστης είναι ήδη συνδεδεμένος στην εφαρμογή GP tom, μπορείτε να καλέσετε τη μέθοδο Get status. Αυτή η μέθοδος σάς επιτρέπει να ανακτήσετε τρέχουσες πληροφορίες σχετικά με την κατάσταση της εφαρμογής και τον συνδεδεμένο έμπορο. Λεπτομερείς πληροφορίες για τη χρήση και την υλοποίηση της μεθόδου μπορείτε να βρείτε στην τεκμηρίωση iOS για τη μέθοδο Get status.