Σκοπός:

Σε αυτή τη μελέτη περιγράφονται οι ενέργειες που πρέπει να γίνουν ώστε οι συσκευές POS συγκεκριμένων NSPs να συνδεθούν με το Pegasus Web App, ώστε να είναι δυνατή η καταχώρηση μιας πληρωμής με POS από τον πελάτη.

Προϋποθέσεις:

• Θα πρέπει να έχετε ένα πλήρως αναβαθμισμένο Pegasus Web App
• Η έκδοση των Windows που λειτουργεί σωστά το Devices ειναι τα Windows 10 και οι νεότερες εκδόσεις.
• Για τις εγκαταστάσεις που ήδη έχουν κάποια version του Pegasus .NET Devices, προτείνουμε σε κάθε περίπτωση να κατεβάσετε την πιο πρόσφατη (θα πρέπει να κάνετε απεγκατάσταση στην παλιά).

Εγκατάσταση Pegasus .NET Devices

Θα πρέπει να εγκαταστήσετε το Pegasus .Net Devices ώστε οι συσκευές POS να μπορούν να επικοινωνήσουν με το Pegasus Web App. Δείτε τη μελέτη Pegasus .NET Devices & Pegasus Web App - Εγκατάσταση.

Στη συνέχεια και στο παράθυρο του Pegasus Devices, πρέπει να κάνετε κλικ στο εικονίδιο με τα βελάκια δεξιά από το πεδίο [Κλειδί Επικοινωνίας].

Θα σας παράξει αυτόματα ένα κλειδί, το οποίο πρέπει να το καταχωρήσετε στο πεδίο [Κλειδί Επικοινωνίας] της οθόνης στο Pegasus Web App (βλ. παρακάτω). Προσοχή: το κλειδί αυτό δεν μπορεί να εμφανιστεί ξανά. Αν το ξεχάσετε, θα πρέπει να δημιουργήσετε ένα νέο.

Pegasus Web App: Βασικές Ρυθμίσεις

1. Στο μενού [Toolbox->Εργαλεία Παραμετροποίησης->POS Πληρωμών->WebSocket Servers] συμπληρώνετε τα πεδία:

• IP: καταχωρείτε την IP του η/υ στον οποίο εκτελείται ο WebSocket Server. Υπενθυμίζουμε ότι ο WebSocket Server αρκεί να τρέχει μόνο σε έναν η/υ στο δίκτυο.

Σημείωση: Η IP αυτή πρέπει να είναι static. Για να βρείτε την IP, αρκεί να εκτελέσετε την εντολή ipconfig στον η/υ όπου εκτελείται ο WebSocket server. Aν εκτελείται στον ίδιο η/υ όπου λειτουργεί και το Pegasus Web App, μπορείτε να καταχωρήσετε την τιμή localhost .

• Port: καταχωρείτε την θύρα με την οποία εκκινήθηκε ο WebSocket Server πχ 50063
• Κλειδί Επικοινωνίας: καταχωρείτε το κλειδί επικοινωνίας που παράξατε από την οθόνη του WebSocket Server (βλ. παραπάνω)

Από το button “Έλεγχος συνδεσιμότητας” βλέπετε αν είναι δυνατή η επικοινωνία. Προσοχή! Για να μπορέσει να γίνει σύνδεση, θα πρέπει να έχετε εκτελέσει το Pegasus .NET Devices καθώς και να έχετε εκκινήσει τον WebSocket Server.

Αν η επικοινωνία δεν ήταν εφικτή κινείστε με βάση το μήνυμα που εμφανίζεται στην οθόνη. Για να εμφανιστεί το μήνυμα λάθους, μπορεί να χρειαστεί να περιμένετε μερικά δευτερόλεπτα.

Συνήθη προβλήματα

Errors κατά τη διαδικασία [Ελέγχου Συνδεσιμότητας]:

• Μήνυμα Λάθους: “Ανεπιτυχής Προσπάθεια Σύνδεσης στον WebSocket Server.”
1. Ελέγχετε ότι έχει εκκινηθεί ο server από το Pegasus .NET CnA App
2. Ελέγχετε ότι μπορείτε να “επικοινωνήσετε” με την IP που δώσατε π.χ. εκτελώντας ένα ping
3. Ελέγχετε οτι η πόρτα που ορίσατε δεν χρησιμοποιείται από κάποια άλλη διεργασία. Μπορείτε να το ελέγξετε, εκτελώντας στο cmd την εντολή netstat -ano | find "50063"
   
   
• Μήνυμα Λάθους: “SecurityError: Failed to construct 'WebSocket” - Google Chrome
1. Ορίζετε το url ws://ip:port στο flag chrome://flags/#unsafely-treat-insecure-origin-as-secure του browser. Αντικαθιστάτε την ip και port με τα πραγματικά στοιχεία
   
   ΠΡΟΣΟΧΗ: θα πρέπει να γίνει επανεκκίνηση του browser σας ώστε να ενεργοποιηθεί η ρύθμιση αυτή.
   
   
• Μήνυμα Λάθους: “The operation is insecure: Code XX” - Mozilla Firefox
1. Πηγαίνετε στο about:config του firefox βρίσκετε το network.websocket.allowInsecureFromHTTPS και το κάνετε true.
   
   
• Μήνυμα Λάθους: "Το κλειδί επικοινωνίας δεν είναι σωστό. Μπορείτε να φτιάξετε ένα κλειδί επικοινωνίας από την οθόνη του Devices.exe που τρέχει στον υπολογιστή σας"
  1. Δεν έχετε ορίσει το σωστό κλειδί επικοινωνίας στην οθόνη [WebSocket Servers]. Επιβεβαιώστε ότι έχετε ορίσει το σωστό

• Μήνυμα Λάθους: "Βεβαιωθείτε ότι έχετε παράξει το κλειδί επικοινωνίας"
  1. Αυτό το μήνυμα πιθανώς θα εμφανίστει σε μια νέα εγκατάσταση Pegasus Devices και εφόσον δεν έχετε δημιουργήσει το κλειδί επικοινωνίας. Δημιουργήστε το και καταχωρήστε το σύμφωνα με τις οδηγίες αυτής της μελέτης
     
     
• Μήνυμα Λάθους: "Παρουσιάστηκε πρόβλημα στα Δεδομένα Εκτύπωσης"
  1. Επιβεβαιώστε ότι είναι ενεργό το service [Windows Management Instrumentation]. 

Ρυθμίσεις για τις Συσκευές POS

Οι Pegasus Web App εφαρμογές συνδέονται μέσω του Pegasus .NET Devices με τα EFT/POS των παρακάτω NSPs:

• Παραμετροποίηση Cardlink (ecr2eftdll.6.3.0) | Συμβατή με Α1155
• Παραμετροποίηση EDPS (EDPS Json Protocol) | Συμβατή με Α1155

Κάνετε κλικ στo ανάλογο link ώστε να σας εμφανιστούν οι σχετικές οδηγίες.

Σημείωση: για τις επιχειρήσεις που δεν είναι υπόχρεες για διασύνδεση με βάση το νόμο Α1155/09-10-2023, μπορείτε να ακολουθήσετε τις εξής οδηγίες, ανάλογα με τον NSP:

• Cardlink
• Euronet
• Mellon

Επίσης, για τις ίδιες περιπτώσεις και εφόσον έχετε ολοκληρώσει τις ρυθμίσεις και αντιμετωπίζετε προβλήματα επικοινωνίας μεταξύ του Pegasus Web App και του POS, δείτε τα βήματα της μελέτης Σύνδεση POS και αντιμετώπιση προβλημάτων σύνδεσης .