Ενσωματώσεις POS

Η σελίδα ρυθμίσεων Ενσωματώσεις συνδέει έναν επιλέξιμο server HandyCafe με ένα τερματικό Ödeal D2D. Η διαθεσιμότητα ελέγχεται μέσω του HandyCafe Cloud. Το μενού και η σελίδα κρύβονται εντελώς όταν το καφέ δεν έχει δικαίωμα να χρησιμοποιεί το Ödeal.

Πριν Ξεκινήσετε

Χρειάζεστε ενεργή συνδρομή HandyCafe Cloud, ένα κλειδί εμπόρου (merchant key) και ένα μυστικό κλειδί (secret key) του Ödeal. Πρέπει επίσης να δημιουργήσετε το τερματικό στην περιοχή Cihazlarım του Ödeal. Το ακριβές όνομα που δίνετε σε αυτό το τερματικό είναι το externalDeviceKey του. Ξεκινήστε με το περιβάλλον Stage. Περάστε στο περιβάλλον Production μόνο αφού το Ödeal εγκρίνει τα διαπιστευτήρια παραγωγής και τη ρύθμιση της επιστροφής κλήσης.

Ρύθμιση του Ödeal

1. Ανοίξτε τις Ρυθμίσεις και επιλέξτε Ενσωματώσεις.
2. Στην ενότητα Λογαριασμός Ödeal, καταχωρήστε το κλειδί εμπόρου και το μυστικό κλειδί που σας έδωσε το Ödeal. Το HandyCafe στέλνει αυτές τις τιμές απευθείας στο HandyCafe Cloud. Κρυπτογραφούνται και δεν αποθηκεύονται στην τοπική βάση δεδομένων ούτε εμφανίζονται ξανά.
3. Επιλέξτε Έλεγχος Σύνδεσης. Όταν υπάρχουν νέα κλειδιά, το HandyCafe τα αποθηκεύει με ασφάλεια πριν ελέγξει τη σύνδεση με το API του Ödeal. Ο έλεγχος αυτός επαληθεύει μόνο τον λογαριασμό Ödeal. Δεν αποδεικνύει ότι το τερματικό είναι συζευγμένο ή online.
4. Προσθέστε το τερματικό. Δώστε ένα σαφές τοπικό όνομα συσκευής. Στο πεδίο Όνομα συσκευής Ödeal (externalDeviceKey), καταχωρήστε το ακριβές όνομα συσκευής που δημιουργήσατε στο Ödeal. Έπειτα συμπληρώστε το προαιρετικό PaxID, το περιβάλλον, τον χρόνο αναμονής πληρωμής, την πόλη του πελάτη, την περιοχή του πελάτη, τον συντελεστή ΦΠΑ συνεδρίας και τον συντελεστή ΦΠΑ παραγγελίας.
5. Ενεργοποιήστε την επιλογή Ενσωμάτωση POS Ενεργή και επιλέξτε Αποθήκευση.
6. Εκδώστε μια απόδειξη μετρητών και ολοκληρώστε μια πληρωμή με κάρτα στο περιβάλλον Stage, ώστε να επαληθεύσετε τη σύζευξη του τερματικού και τις δύο διαδρομές εξόφλησης.

Σε αυτή την έκδοση υποστηρίζεται μόνο ένα ενεργό τερματικό Ödeal ανά server. Έτσι αποτρέπεται η δρομολόγηση μιας πληρωμής σε λάθος τερματικό όσο δεν υπάρχει ακόμη επιλογέας τερματικού για τον ταμία.

Το HandyCafe αποθηκεύει τοπικά τον κατάλογο των τερματικών πριν το Cloud επαληθεύσει ένα νέο ζεύγος διαπιστευτηρίων. Η απόρριψη των διαπιστευτηρίων από το Ödeal δεν διαγράφει το όνομα του τερματικού ούτε τα πεδία σύζευξης. Ένα τερματικό που χρειάζεται νέα διαπιστευτήρια αποθηκεύεται ως ανενεργό μέχρι να επαληθευτούν αυτά τα διαπιστευτήρια για το επιλεγμένο περιβάλλον του.

Η σελίδα Ενσωματώσεις διαβάζει τον κατάλογο των τερματικών απευθείας από την τοπική βάση δεδομένων SQLite και τον εμφανίζει χωρίς να περιμένει το Cloud. Μόνο η κατάσταση των κρυπτογραφημένων διαπιστευτηρίων και η απομακρυσμένη άδεια του παρόχου απαιτούν αίτημα προς το Cloud.

Αν το Ödeal απορρίψει τη ρύθμιση, το HandyCafe εμφανίζει την εξήγηση που επέστρεψε το Ödeal. Μια απάντηση ότι δεν βρέθηκε προφίλ οργανισμού σημαίνει ότι το ζεύγος merchant και secret δεν ανήκει σε οργανισμό του επιλεγμένου περιβάλλοντος Stage ή Production.

Συμπεριφορά Πληρωμών

Όταν η ενεργή μέθοδος πληρωμής είναι μετρητά ή κάρτα, η εξόφληση συνεδρίας σε υπολογιστή, η εξόφληση συνεδρίας σε κονσόλα και το κλείσιμο μεμονωμένης παραγγελίας στέλνουν στο Ödeal ένα καλάθι με κλειδί idempotency. Τα μετρητά αποστέλλονται ως η τεκμηριωμένη επιλογή πληρωμής CASH του Ödeal. Το τερματικό καταγράφει την πληρωμή με μετρητά και εκτυπώνει το φορολογικό δελτίο ή την απόδειξη e-Archive χωρίς να ανοίξει οθόνη είσπραξης με κάρτα. Η κάρτα αποστέλλεται ως CREDITCARD. Το HandyCafe περιμένει το αποτέλεσμα της επιστροφής κλήσης όσο ο πελάτης ολοκληρώνει την πληρωμή στο τερματικό. Μια εξόφληση που περιέχει και μετρητά και κάρτα στέλνει και τις δύο επιλογές πληρωμής με τα αντίστοιχα ποσά τους.

Ο πελάτης μπορεί να επιλέξει δόσεις στο τερματικό, όταν το επιτρέπουν η κάρτα και η σύμβαση του εμπόρου. Το HandyCafe αποθηκεύει τον αριθμό δόσεων που αναφέρθηκε μαζί με την τοπική πώληση. Η τοπική πώληση οριστικοποιείται μόνο αφού το Ödeal επιβεβαιώσει τη συναλλαγή. Αν η τοπική οριστικοποίηση αποτύχει μετά την επιβεβαίωση, το HandyCafe ζητά αυθημερόν ακύρωση. Μια αποτυχημένη ακύρωση παράγει σφάλμα που απαιτεί χειροκίνητη συμφωνία και πρέπει να ελεγχθεί στην αναφορά συναλλαγών του Ödeal. Οι τύποι μεθόδων πληρωμής πέρα από τα μετρητά και την κάρτα συνεχίζουν μέσω της υπάρχουσας ροής εξόφλησης του HandyCafe.

Έλεγχοι και Λειτουργίες Τερματικού

Ο Έλεγχος Σύνδεσης επαληθεύει μόνο τα διαπιστευτήρια εμπόρου του Ödeal και την πρόσβαση στο API. Δεν εκτυπώνει απόδειξη, δεν χρεώνει κάρτα ούτε αποδεικνύει ότι το externalDeviceKey είναι συζευγμένο με το τερματικό.

Η παρεχόμενη τεκμηρίωση του D2D API δεν ορίζει ξεχωριστά σημεία πρόσβασης για Δοκιμαστική Εκτύπωση Απόδειξης ή Δοκιμαστική Χρέωση. Ο έλεγχος αποδοχής γίνεται με κανονικά καλάθια στο περιβάλλον Stage: στείλτε ένα καλάθι μετρητών και επαληθεύστε το δελτίο που εκτυπώθηκε, έπειτα στείλτε ένα καλάθι κάρτας και ολοκληρώστε μια συναλλαγή εφάπαξ ή με δόσεις στο τερματικό. Χρησιμοποιήστε μόνο τα στοιχεία δοκιμαστικής κάρτας που παρέχει το Ödeal.

Οι περιπτώσεις αποδοχής του Ödeal περιλαμβάνουν το κλείσιμο ημέρας και την επανεκτύπωση της τελευταίας απόδειξης, αλλά αυτές είναι λειτουργίες του ίδιου του τερματικού. Το D2D δεν τεκμηριώνει απομακρυσμένες κλήσεις API για αυτές, οπότε το HandyCafe δεν τις εμφανίζει ως απομακρυσμένα κουμπιά.

Απομακρυσμένη Ενεργοποίηση και Απενεργοποίηση

Οι διαχειριστές του HandyCafe ελέγχουν το Ödeal από το Admin > Ρυθμίσεις Admin > Πάροχοι POS στο Dashboard. Ο γενικός διακόπτης είναι ο κύριος έλεγχος. Οι προεπιλογές χώρας χρησιμοποιούν διψήφιους κωδικούς ISO, όπως TR. Οι έλεγχοι ανά καφέ μπορούν να ανοίξουν ή να κλείσουν ρητά το Ödeal για μία άδεια. Μια απόφαση για συγκεκριμένο καφέ υπερισχύει της προεπιλογής της χώρας. Η επαναφορά της απόφασης του καφέ το κάνει να ακολουθεί ξανά τη ρύθμιση της χώρας του.

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

Ο server ελέγχει τη διαθεσιμότητα μέσω του HandyCafe Cloud και κρατά προσωρινά την τελευταία επιτυχώς επαληθευμένη απόφαση χώρας ή καφέ. Ο κατάλογος παρόχων επιστρέφει HTTP 200 με δομημένο error.code όταν το διαπιστευτήριό του δεν είναι έγκυρο. Η εφαρμογή στον υπολογιστή χειρίζεται αυτή την απάντηση ανανεώνοντας το διαπιστευτήριο και επαναλαμβάνοντας την κλήση. Μια προσωρινή αποτυχία αυθεντικοποίησης ή δικτύου δεν μετατρέπει μια ενεργοποιημένη απόφαση διαχειριστή σε απενεργοποιημένη, οπότε το μενού Ενσωματώσεις παραμένει σταθερό. Μια μεταγενέστερη επιτυχής απάντηση ενημερώνει αμέσως την προσωρινή μνήμη, ακόμη και όταν πρόκειται για απόφαση απενεργοποίησης από διαχειριστή. Χωρίς προηγούμενη επαληθευμένη απόφαση, μια άγνωστη χώρα του καφέ, μια ανενεργή συνδρομή ή ένας απενεργοποιημένος πάροχος κρατούν τη σελίδα κρυφή. Οι νέες λειτουργίες Ödeal εξουσιοδοτούνται πάντα εκ νέου από το Cloud, ακόμη και όταν χρησιμοποιείται η αποθηκευμένη ορατότητα. Όταν το συγχρονισμένο προφίλ του καφέ δεν έχει χώρα, χρησιμοποιείται η χώρα που είναι αποθηκευμένη στην άδεια.

Ασφάλεια και Ανάκτηση

Τα διαπιστευτήρια Ödeal κρυπτογραφούνται στο HandyCafe Cloud με το κλειδί vault της εγκατάστασης. Τα αιτήματα επιστροφής κλήσης αυθεντικοποιούνται με το ρυθμισμένο κλειδί αιτήματος ή με τις κεφαλίδες merchant και secret του Ödeal. Οι κωδικοί αναφοράς του καλαθιού παραμένουν σταθεροί για κάθε παραγγελία ή συνεδρία. Η επανάληψη της ίδιας εξόφλησης δεν δημιουργεί δεύτερη χρέωση.

Η ακύρωση στο Ödeal είναι διαθέσιμη μόνο σύμφωνα με τους κανόνες αυθημερόν ακύρωσης του Ödeal, πριν κλείσει η παρτίδα του τερματικού. Ένα εκκρεμές καλάθι μπορεί να αφαιρεθεί ξεχωριστά πριν ολοκληρωθεί η πληρωμή. Το Ödeal D2D δεν παρέχει γενική λειτουργία επιστροφής χρημάτων. Χρησιμοποιήστε το back office και την αναφορά συναλλαγών του Ödeal όταν έχει παρέλθει το χρονικό περιθώριο ακύρωσης.

Το Ödeal D2D δεν παρέχει τεκμηριωμένη απομακρυσμένη αναφορά Z ούτε λειτουργία κλεισίματος ημέρας. Ολοκληρώστε το κλείσιμο ημέρας στο τερματικό. Το HandyCafe μπορεί να διαβάζει αναφορές συναλλαγών για τη συμφωνία των λογαριασμών και καταγράφει τις επιστροφές κλήσης payback από το Ödeal.