PireosPay Εγχειρίδιο Χρήσης Prestashop Module

Το PireosPay επιτρέπει στους πελάτες σας να πληρώνουν με **κάρτα** ή με **IRIS** (άμεση τραπεζική μεταφορά) μέσω της Τράπεζας Πειραιώς / epay eCommerce. Όταν ο πελάτης ολοκληρώνει την παραγγελία του, μεταφέρεται σε μια ασφαλή σελίδα πληρωμής της τράπεζας και μόλις πληρώσει, επιστρέφει αυτόματα στο κατάστημά σας.

Αυτός ο οδηγός δεν προϋποθέτει τεχνικές γνώσεις. Όπου χρειάζεται ο web host σας ή κάποιος developer, το αναφέρουμε.

• Το κατάστημά σας πρέπει να λειτουργεί με **HTTPS** (το λουκετάκι στον browser). Οι πάροχοι πληρωμών με κάρτα το απαιτούν.
• Ο server σας πρέπει να έχει ενεργοποιημένη την επέκταση **PHP SOAP** — μέσω αυτής επικοινωνεί το πρόσθετο με την τράπεζα. Οι περισσότεροι πάροχοι φιλοξενίας την έχουν ήδη ενεργή, αλλά αν αργότερα το πρόσθετο εμφανίσει σφάλμα σύνδεσης, ζητήστε από τον host σας να το επιβεβαιώσει.
• Χρειάζεστε συνεργασία με την **Euronet Merchant Services / Τράπεζα Πειραιώς** για να δέχεστε πληρωμές. Αν δεν την έχετε ακόμα, επικοινωνήστε μαζί τους για να ξεκινήσει η διαδικασία.

1. Στο διαχειριστικό του PrestaShop, πηγαίνετε στο **Πρόσθετα → Διαχείριση Πρόσθετων** (Modules → Module Manager).
2. Πατήστε **Μεταφόρτωση πρόσθετου** και επιλέξτε το αρχείο `vX.X.X-pireospay.zip` (ή, αν το κάνετε χειροκίνητα, ανεβάστε τον φάκελο `pireospay` στον φάκελο `modules` του καταστήματός σας).
3. Αναζητήστε **PireosPay** στη λίστα πρόσθετων και πατήστε **Εγκατάσταση**.
4. Πατήστε **Διαμόρφωση** για να ανοίξετε τη σελίδα ρυθμίσεων — θα την επισκεφθείτε ξανά αρκετές φορές καθώς προχωράτε σε αυτόν τον οδηγό.

Δεν μπορείτε να προχωρήσετε σε δοκιμές (ούτε φυσικά σε κανονική λειτουργία) μέχρι η τράπεζα να σας δώσει ένα σύνολο στοιχείων σύνδεσης: **AcquirerID**, **MerchantID**, **PosID**, **Username** και **Password**. Η διαδικασία είναι η εξής:

1. Η τράπεζα θα σας στείλει email ζητώντας τεχνικές πληροφορίες για το κατάστημά σας (URLs κ.λπ.).
2. Στη σελίδα **Διαμόρφωση** του πρόσθετου, κατεβείτε στην ενότητα **"PireosPay Data and CSS File"** και πατήστε **Generate Form Information**. Εμφανίζονται όλες οι πληροφορίες που χρειάζεται η τράπεζα, με κάποια κενά (σημειωμένα με μπλε χρώμα) που πρέπει να συμπληρώσετε εσείς — όνομα, τηλέφωνο, επωνυμία εταιρείας κ.λπ.
3. Αντιγράψτε αυτές τις πληροφορίες και στείλτε τις με email στο τεχνικό τμήμα της τράπεζας, μαζί με το αν επιθυμείτε να προσφέρετε **δόσεις** ή όχι.
4. Η τράπεζα θα σας απαντήσει με έναν **δοκιμαστικό λογαριασμό** (test AcquirerID/MerchantID/PosID/Username/Password). Καταχωρήστε τα στην ενότητα **"Piraeus Paycenter: information for system connection"** της σελίδας Διαμόρφωση και πατήστε **Save Settings**.
5. Μόλις ολοκληρωθούν επιτυχώς όλες οι δοκιμές (δείτε Ενότητα 6), η τράπεζα θα σας δώσει τον **κανονικό (live) λογαριασμό**. Αντικαταστήστε τα δοκιμαστικά στοιχεία με τα κανονικά στην ίδια σελίδα — αυτή είναι η μόνη αλλαγή που χρειάζεται για να περάσετε από δοκιμαστική σε κανονική λειτουργία.

Αν πουλάτε σε περισσότερες από μία **γλώσσες**, θα δείτε ξεχωριστό πεδίο **PosID** για κάθε γλώσσα — η τράπεζα εκδίδει ένα ανά γλώσσα, οπότε συμπληρώστε τα όλα.

Αν πουλάτε σε περισσότερα από ένα **νομίσματα**, δείτε την Ενότητα 5 παρακάτω — θα χρειαστείτε επιπλέον λογαριασμό ανά νόμισμα, όχι μόνο ανά γλώσσα.

Όλα τα παρακάτω βρίσκονται στη σελίδα **Διαμόρφωση** του πρόσθετου.

### Στοιχεία σύνδεσης

AcquirerID, MerchantID, PosID(s), Username, Password — σας δίνονται από την τράπεζα (Ενότητα 3 παραπάνω).

### Auto Redirect (Αυτόματη ανακατεύθυνση)

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

### Τύπος συναλλαγής (Request type)

- **Authorize sale (Προέγκριση)**: το ποσό απλώς δεσμεύεται στην κάρτα του πελάτη· εσείς (ή η ομάδα σας) επιβεβαιώνετε τη χρέωση αργότερα, μέσω του διαχειριστικού εργαλείου της τράπεζας. Χρησιμοποιήστε το αν θέλετε να ελέγχετε τις παραγγελίες πριν χρεώσετε την κάρτα (π.χ. όταν το απόθεμα δεν είναι εγγυημένο).

- **Instant Payment (Άμεση πληρωμή)**: ο πελάτης χρεώνεται αμέσως μόλις πληρώσει. Αυτό χρησιμοποιούν τα περισσότερα καταστήματα.

Αν χρησιμοποιείτε "Authorize sale", ορίστε επίσης το **"Maximum days while your authorization lasts"** (έως 30 ημέρες) — πόσο χρόνο έχετε για να επιβεβαιώσετε τη χρέωση πριν λήξει.

### Δόσεις (Installments)

Ενεργοποιήστε το μόνο αν η τράπεζα έχει επιβεβαιώσει ότι μπορείτε να προσφέρετε δόσεις. Αν το ενεργοποιήσετε, ορίστε μέγιστο αριθμό δόσεων (ή αφήστε 0 για απεριόριστο), και προαιρετικά προσθέστε κανόνες στην ενότητα **"Card Installment management"** πιο κάτω στη σελίδα — π.χ. "παραγγελίες €100–200 να χωρίζονται σε έως 6 δόσεις".

### Λογότυπο πληρωμής

Στην ενότητα **"PireosPay Extra Settings"**, μπορείτε να ανεβάσετε μια εικόνα που θα βλέπουν οι πελάτες δίπλα στην επιλογή PireosPay κατά την ολοκλήρωση παραγγελίας.

**Παραλείψτε αυτή την ενότητα αν το κατάστημά σας χρησιμοποιεί μόνο ένα νόμισμα.**

Η τράπεζα εκδίδει **ξεχωριστό λογαριασμό** (AcquirerID/MerchantID/Username/Password/PosID) για κάθε νόμισμα που δέχεστε — αυτό είναι απαίτηση της τράπεζας και δεν μπορεί να παρακαμφθεί από το πρόσθετο. Αν έχετε ενεργοποιήσει το PireosPay για περισσότερα από ένα νομίσματα (από τα Πρόσθετα → Πληρωμές, όπου ορίζετε ποια νομίσματα δέχεται κάθε τρόπος πληρωμής), θα πρέπει να:

1. Ζητήσετε από την τράπεζα δεύτερο (ή τρίτο...) λογαριασμό για το επιπλέον νόμισμα.
2. Στη σελίδα Διαμόρφωση, βρείτε την ενότητα **"Additional Currency Accounts"** και πατήστε **Add currency account**, συμπληρώνοντας το AcquirerID/MerchantID/Username/Password/PosID για εκείνο το νόμισμα.

Το **προεπιλεγμένο νόμισμα** του καταστήματός σας συνεχίζει να χρησιμοποιεί τα βασικά στοιχεία σύνδεσης της Ενότητας 4 — χρειάζεται να προσθέσετε εγγραφή εδώ μόνο για τα *υπόλοιπα* νομίσματα.

Η Τράπεζα Πειραιώς απαιτεί να εμφανίζετε συγκεκριμένα εικονίδια στο site σας, ώστε οι πελάτες να αναγνωρίζουν την ασφαλή διαδικασία πληρωμής (Visa Secure, Mastercard Identity Check, και — αν δέχεστε American Express — SafeKey). Μπορείτε να κατεβάσετε όλο το απαιτούμενο υλικό από εδώ:

https://www.epayworldwide.gr/wp-content/uploads/2022/10/Icons.zip

Προσθέστε τα λογότυπα καρτών (Visa/Mastercard/Maestro, και Diners/Discover/Amex αν ισχύει) στην αρχική σελίδα σας, και τα εικονίδια "Visa Secure"/"Mastercard Identity Check" στην αρχική σελίδα και σε τυχόν σελίδα ασφάλειας/εμπιστοσύνης που έχετε.

Μόλις καταχωρήσετε τα **δοκιμαστικά** στοιχεία σύνδεσης:

1. Το εγχειρίδιο της τράπεζας περιλαμβάνει μια λίστα με **test cases** και δοκιμαστικούς αριθμούς καρτών. Ορισμένα είναι υποχρεωτικά (καλύπτουν μια επιτυχημένη πληρωμή, μια απορριφθείσα πληρωμή, και μια προσπάθεια διπλής χρέωσης)· τα υπόλοιπα είναι προαιρετικά ανάλογα με τις ανάγκες του καταστήματός σας — δόσεις, συγκεκριμένους τύπους καρτών, άλλα νομίσματα κ.λπ.
2. Κάντε δοκιμαστικές παραγγελίες στο κατάστημά σας με αυτούς τους αριθμούς καρτών και επιβεβαιώστε ότι κάθε μία συμπεριφέρεται όπως αναμένεται (μια επιτυχημένη εμφανίζει παραγγελία, μια απορριφθείσα εμφανίζει μήνυμα σφάλματος κ.ο.κ.).
3. Στείλτε email στο τεχνικό τμήμα της τράπεζας μόλις ολοκληρωθούν οι δοκιμές.

1. Η τράπεζα σας στέλνει τα **κανονικά (live)** AcquirerID/MerchantID/PosID/Username/Password.
2. Αντικαταστήστε τα δοκιμαστικά στοιχεία με τα κανονικά στη σελίδα Διαμόρφωση (Ενότητα 3, βήμα 5) και αποθηκεύστε.
3. Βεβαιωθείτε ότι το πρόσθετο είναι **ενεργό** για τα νομίσματα και τις γλώσσες που πραγματικά χρησιμοποιείτε (Πρόσθετα → Πληρωμές).

Αυτό ήταν — είστε σε κανονική λειτουργία.

Όταν μια πληρωμή είναι επιτυχής, η παραγγελία δημιουργείται με κατάσταση **"PireosPay - Accepted!"**. Αν απορριφθεί ή αποτύχει, δεν δημιουργείται παραγγελία και ο πελάτης βλέπει μια εξήγηση στην οθόνη του (χωρίς ευαίσθιες τεχνικές λεπτομέρειες — αυτές κρατούνται μόνο για δικό σας αρχείο).

**Για να δείτε τις τεχνικές λεπτομέρειες πληρωμής μιας συγκεκριμένης παραγγελίας** (ποιο δίκτυο κάρτας χρησιμοποιήθηκε, αν ήταν Κάρτα ή IRIS, τους κωδικούς αναφοράς της τράπεζας κ.λπ.), ανοίξτε την παραγγελία από τις **Παραγγελίες** στο διαχειριστικό σας — εμφανίζεται ένα πλαίσιο **"PireosPay Transaction Details"** στη σελίδα της παραγγελίας, αν η πληρωμή έγινε μέσω PireosPay.

Περιστασιακά, ένας πελάτης ολοκληρώνει μια πληρωμή στην πλευρά της τράπεζας, αλλά ο browser του δεν επιστρέφει ποτέ στο κατάστημά σας για να την επιβεβαιώσει — δεν δημιουργείται παραγγελία, παρόλο που η τράπεζα μπορεί να έχει χρεώσει το ποσό. Αυτό συμβαίνει συχνότερα με το **IRIS**, καθώς ο πελάτης συχνά επιβεβαιώνει την πληρωμή μέσα από την τραπεζική εφαρμογή του κινητού του, ενώ η καρτέλα του browser που πρέπει να τον επαναφέρει στο κατάστημά σας μένει ανοιχτή αλλού (και μερικές φορές κλείνει).

Το πρόσθετο περιλαμβάνει ακριβώς γι' αυτό ένα δίχτυ ασφαλείας: έναν αυτόματο ωριαίο έλεγχο που σας στέλνει email όποτε συμβαίνει κάτι τέτοιο, ώστε να αναζητήσετε την παραγγελία απευθείας στην τράπεζα αντί να το μαθαίνετε μόνο όταν παραπονεθεί ο πελάτης.

**Για να το ενεργοποιήσετε:**

1. Στη σελίδα Διαμόρφωση, βρείτε την ενότητα **"Unresolved Transaction Alerts"**.
2. Ορίστε τη διεύθυνση email που θα λαμβάνει τις ειδοποιήσεις, και πόσο χρόνο να περιμένει πριν θεωρήσει μια συναλλαγή «ασαφή» (τα 60 λεπτά είναι μια λογική προεπιλογή).
3. Αντιγράψτε το **Scheduler URL** που εμφανίζεται εκεί.
4. Ζητήστε από τον πάροχο φιλοξενίας σας να εκτελεί αυτό το URL **μία φορά την ώρα**. Οι περισσότεροι πάροχοι έχουν ενότητα «Cron Jobs» στον πίνακα ελέγχου τους (cPanel, Plesk κ.λπ.) όπου επικολλάτε το URL και επιλέγετε «κάθε ώρα» — αν δεν είστε σίγουροι πώς γίνεται, προωθήστε απλώς αυτή την ενότητα στον host σας και ζητήστε του να το ρυθμίσει.

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

- **Για οτιδήποτε αφορά τη σύνδεση με την τράπεζα, δοκιμαστικές κάρτες ή την κατάσταση του λογαριασμού σας**: επικοινωνήστε απευθείας με την υποστήριξη της Euronet Merchant Services / Τράπεζας Πειραιώς — αναφέρετε το **Support Reference ID** αν το έχετε από κάποια αποτυχημένη συναλλαγή, βοηθάει να τη βρουν άμεσα.

- **Για οτιδήποτε αφορά το ίδιο το πρόσθετο** (εγκατάσταση, διαμόρφωση, κάποιο πρόβλημα): ανοίξτε ένα ticket υποστήριξης, αναφέροντας τα στοιχεία της άδειας/αγοράς σας.