Σκοπός:

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

Ρυθμίσεις Cardlink

Εφόσον το POS συνδέεται μέσω ethernet:

1. Θα πρέπει να εξασφαλιστεί ότι το POS είναι σε [Online Mode]. Την παραπάνω ρύθμιση θα πρέπει να την ελέγξει (και αν χρειαστεί να την ορίσει) τεχνικός της Cardlink.
2. Θα πρέπει να εξασφαλιστεί η ακριβής τιμή της IP και της πόρτας που χρησιμοποιεί το POS. Ενδεχομένως να χρειαστεί και πάλι επικοινωνία με τεχνικό της Cardlink.
3. Θα πρέπει να γίνουν ενέργειες για παράκαμψη του τείχους προστασίας του router της εγκατάστασης για την πόρτα που χρησιμοποιεί το POS.

Σε κάθε περίπτωση, για την επικοινωνία με το POS χρησιμοποιούμε το EcrDll.dll της κατασκευάστριας εταιρείας. Για να εκτελεστεί σωστά το EcrDll.dll που χρησιμοποιεί η εφαρμογή, θα πρέπει στο σύστημα με Windows 10 να υπάρχουν τα αρχεία WS2_32.dll, KERNEL32.dll, MSVCR100.dll
Αν υπάρχει θέμα στην κλήση του EcrDll.dll, δοκιμάστε να εγκαταστήσετε στο pc σας το MSVC++ 2010 redistributable (https://www.microsoft.com/en-us/download/details.aspx?id=26999)

Ρυθμίσεις Πήγασου

WebSocket Server

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

1. Κατεβάζετε το αρχείο Pegasus .NET Devices και το εκτελείτε. Καλείστε να επιλέξετε το path εγκατάστασης. Το default path εγκατάστασης είναι το C:\TESAESA\Pegasus_Devices\ .

Προτείνεται αν αυτό χρειαστεί να αλλάξει, να χρησιμοποιηθεί κάποιο path χωρίς κενά και μόνο με λατινικούς χαρακτήρες. Θα εγκατασταθεί η εφαρμογή Pegasus .NET Devices και θα δημιουργηθεί το shortcut [Devices.exe] στην Επιφάνεια Εργασίας.

Εκτελείτε την εφαρμογή. Δεν θα ανοίξει κάποιο παράθυρο αλλά θα προσθέσει στα Toolbar Items της Taskbar των Windows την εφαρμογή [Pegasus Devices]. 

Pegasus .NET Devices: Βασικές Ρυθμίσεις και Εκτέλεση

1. Με διπλό κλικ στο toolbar item, ανοίγει το βασικό παράθυρο της εφαρμογής.

Πριν κάνετε οποιαδήποτε ενέργεια, θα χρειαστεί να δημιουργήσετε χειροκίνητα έναν φάκελο ονόματι logs στο επίπεδο C:\TESAESA\logs.

Ορίζετε την Πόρτα στην οποία θα ακούει ο WebSocket Server. Είναι η πόρτα του WebSocket Server στην οποία θα δέχεται requests από το Web App. Ως προεπιλεγμένη τιμή έρχεται η 50063.

2. Με κλικ στο button [Save Config/Start WS Server], εκκινεί ο websocket server και το log ενημερώνεται σχετικά:

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

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

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

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

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

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

• Μήνυμα Λάθους: “Ανεπιτυχής Προσπάθεια Σύνδεσης στον 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.

Συσκευές POS

1. Στην επιλογή [Toolbox->Εργαλεία Παραμετροποίησης->POS Πληρωμών->Συσκευές POS] καταχωρείτε μια νέα εγγραφή.
2. Στην οθόνη που εμφανίζεται, καταχωρείτε τα εξής(μεταξύ άλλων):

• Τύπος: Cardlink
• Λειτουργικό Σύστημα:
  • x64, αν είναι 64-bit
  • x86, αν είναι 32-bit
• Είδος Σύνδεσης: ανάλογα με την επιλογή, συμπληρώνετε τα σχετικά πεδία:
  • Ethernet:
    • IP: την διεύθυνση IP του POS
    • Port: τη θύρα λειτουργίας του POS
    • WebSocket Server: επιλέγετε τη σχετική εγγραφή(βλ. Παράγραφο WebSocket Server)
  • Σειριακή(COM):
    • Σειριακή Πόρτα: ο αριθμός της serial port που έχει συνδεθεί το POS πχ [COM1]
    • Baud Rate/Parity/Stop Bits/Byte Size: τα αφήνετε ως έχουν
    • WebSocket Server: επιλέγετε τη σχετική εγγραφή(βλ. Παράγραφο WebSocket Server)

Σημείωση: μπορείτε να επαναλάβετε τη διαδικασία εφόσον διαθέτετε παραπάνω από ένα POS.

Ρυθμίσεις POS

1. Στην επιλογή [Toolbox->Εργαλεία Παραμετροποίησης->POS Πληρωμών->Ρυθμίσεις POS] καταχωρείτε μια νέα εγγραφή.
2. Στην οθόνη που εμφανίζεται, καταχωρείτε τα εξής:
• Συσκευή POS: επιλέγετε αυτή που δημιουργήσατε προηγουμένως
• Τρόπος Είσπραξης: η εφαρμογή σας εμφανίζει αυτόματα μόνο τους τρ.είσπραξης χωρίς ΚΚ λογιστηρίου, καθώς αυτός ο περιορισμός είναι υποχρεωτικός. Ως εκ τούτου, προτείνουμε να αντιγράψετε τον standard τρόπο είσπραξης [99 - Επι Πιστώσει] και να δημιουργήσετε έναν νέο με περιγραφή πχ [πληρωμή με Cardlink]
• Τερματικό: επιλέγετε το τερματικό για το οποίο θέλετε να ισχύει η συγκεκριμένη ρύθμιση
• ΚΚ Λογιστηρίου: 1001 - είσπραξη από πελάτη(πιστωτική)

Σημείωση: μπορείτε να δημιουργήσετε έναν νέο ΚΚ λογιστηρίου, αντιγράφοντας τον παραπάνω.

Pegasus .NET Devices - Εκτέλεση από το Windows Scheduler

Μπορείτε να ρυθμίσετε το Pegasus .NET Devices να τρέχει με την εκκίνηση των Windows.

Στο χρονοπρογραμματιστή των windows μπορείτε να ρυθμίσετε να εκτελείται το exe απο τη διαδρομη \TESAESA\Pegasus_Devices\Devices.exe στην εκκίνηση των Windows, με argument autorun.

Με το argument αυτό, θα εκκινείται και ο server αυτόματα, με την εκτέλεση της εφαρμογής.