Από την έκδοση της εφαρμογής 1.15 και μετά, μπορείτε να πραγματοποιείτε είσοδο και έξοδο από την εφαρμογή απευθείας μέσω του δικού σας συστήματος, χρησιμοποιώντας το API deeplink. Αυτή η δυνατότητα άμεσης σύνδεσης/αποσύνδεσης μέσω API καταργεί την ανάγκη το προσωπικό να μεταβαίνει στην αυτόνομη εφαρμογή GP tom και να εισάγει χειροκίνητα τα διαπιστευτήρια — πλέον μπορείτε να διαχειρίζεστε ολόκληρη τη διαδικασία μέσα από τη δική σας εφαρμογή. Έτσι, μειώνεται ο χρόνος που απαιτείται για την ενεργοποίηση του τερματικού, περιορίζονται τα αιτήματα υποστήριξης που σχετίζονται με τη σύνδεση και —το σημαντικότερο— απλοποιούνται οι ροές εργασίας που περιλαμβάνουν συχνές εναλλαγές προσωπικού ή συσκευών (όπως σε βάρδιες στον κλάδο της φιλοξενίας ή του λιανεμπορίου, ή σε περιπτώσεις διανομέων που μοιράζονται τερματικά μεταξύ των βαρδιών τους).
Σύνδεση στην εφαρμογή
Αίτημα
Διαδρομή deeplink: gptom://login
Παράδειγμα κλήσης:
gptom://login?
username=merchant%40example.com&
password=silneheslo&
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=silneheslo&
newPassword=NoveSilneHeslo1&
tid=123456&
redirectURL=gp%3A%2F%2Fchange-password
Βήμα 2 – Επιβεβαίωση μέσω κωδικού
Η ίδια κλήση, συμπεριλαμβανομένης της παραμέτρου code που στάλθηκε μέσω email. Σε περίπτωση επιτυχίας, ο κωδικός πρόσβασης αλλάζει και μπορείτε να προχωρήσετε σε μια τυπική διαδικασία σύνδεσης.
gptom://change-password?
username=merchant%40example.com&
password=silneheslo&
newPassword=NoveSilneHeslo1&
tid=123456&
code=AsfweWW41515&
redirectURL=gp%3A%2F%2Fchange-password
Αποσύνδεση από την εφαρμογή
Αίτημα
Διαδρομή deeplink: gptom://logout
gp://logout?redirectUrl=gp%3A%2F%2Flogout
Κωδικοί κατάστασης
EN: Request completed successfully.
EN: Request failed — see the error parameter for details.
EN: User cancelled the request inside the GP tom app.
Κωδικοί σφάλματος που σχετίζονται με τη σύνδεση/αποσύνδεση
EN: Μη έγκυρο όνομα χρήστη ή κωδικός πρόσβασης.
EN: The provided TID is not assigned to this user.
EN: The provided TID is already occupied by another user.
EN: The same user is already logged in on this device with a different TID.
EN: First login - password must be set first.
EN: This occurs upon the first login following step 1, when an authorization code is sent via email.
EN: The provided confirmation code for the password change is invalid.
EN: It was not possible to log in user.
EN: Incorrect credentials sent.
EN: Terminal setup has failed. Please contact our support.
Επαλήθευση κατάστασης σύνδεσης
Για να διαπιστώσετε εάν ο χρήστης είναι ήδη συνδεδεμένος στην εφαρμογή GP tom, μπορείτε να καλέσετε τη μέθοδο Get status. Αυτή η μέθοδος σάς επιτρέπει να ανακτήσετε τρέχουσες πληροφορίες σχετικά με την κατάσταση της εφαρμογής και τον συνδεδεμένο έμπορο. Λεπτομερείς πληροφορίες για τη χρήση και την υλοποίηση της μεθόδου μπορείτε να βρείτε στην τεκμηρίωση iOS για τη μέθοδο Get status.