Οδηγός εγκατάστασης Πειραιώς ePOS Paycenter για WooCommerce

Οδηγός εγκατάστασης: Τράπεζα Πειραιώς (Paycenter) για WooCommerce

Ο οδηγός περιγράφει τη ρύθμιση του plugin πληρωμών της OBS για την Τράπεζα Πειραιώς, από τα στοιχεία που χρειάζεστε από την τράπεζα μέχρι τον τελικό έλεγχο πριν το live. Με την αγορά, η ομάδα της OBS κάνει δωρεάν όλα τα παρακάτω βήματα για εσάς.

Τι χρειάζεστε πριν ξεκινήσετε

• Ενεργή σύμβαση epay eCommerce (e-POS Paycenter) με την Τράπεζα Πειραιώς (και ενεργοποίηση IRIS ή δόσεων, αν τις χρειάζεστε).
• Τα στοιχεία διασύνδεσης από την epay: Merchant ID, Acquirer ID, POS ID, Username, Password. Πρώτα λαμβάνετε Redirection Test Account για δοκιμές και μετά Redirection Live Account.
• Πρόσβαση στο Paycenter AdminTool για τον έλεγχο των συναλλαγών.
• Server με PHP 7.4+, ενεργό PHP SOAP extension, HTTPS (SSL) και σταθερή δημόσια IP (ή HTTP proxy με σταθερή IP).
• WordPress 5.8+ και WooCommerce 5.0+.

Βήμα 1: Εγκατάσταση και License key

1. Κατεβάστε το ZIP του plugin και το License key από τον λογαριασμό σας στην OBS.
2. Στο WordPress ανοίξτε Πρόσθετα → Προσθήκη νέου → Μεταφόρτωση πρόσθετου, επιλέξτε το ZIP και πατήστε Ενεργοποίηση. Δείτε και τον γενικό οδηγό εγκατάστασης.
3. Ανοίξτε WooCommerce → Ρυθμίσεις → Πληρωμές → Piraeus Bank. Στο πλαίσιο «Activate for Update» επικολλήστε το License key στο πεδίο «Enter Validation Key» και πατήστε «Activate». Περισσότερα στην ενεργοποίηση άδειας.

Βήμα 2: Δηλώστε τα URLs και την IP στην τράπεζα

Στην κορυφή της σελίδας ρυθμίσεων το plugin εμφανίζει τα στοιχεία που ζητά η Τράπεζα Πειραιώς. Στείλτε τα στην τράπεζα ακριβώς όπως εμφανίζονται:

• Website url: η διεύθυνση του eshop σας
• Referrer url: https://το-domain-σας/checkout/
• Success page: https://το-domain-σας/wc-api/OBS_Piraeusbank_Gateway?peiraeus=success
• Failure page: https://το-domain-σας/wc-api/OBS_Piraeusbank_Gateway?peiraeus=fail
• Cancel page: https://το-domain-σας/wc-api/OBS_Piraeusbank_Gateway?peiraeus=cancel
• Response method: GET or POST
• Server IP Address: η IP του server σας

Εξαιρέστε τα URLs /wc-api/OBS_Piraeusbank_Gateway από cache, firewall (WAF), maintenance mode και κανόνες σύνδεσης, ώστε η απάντηση της τράπεζας να φτάνει πάντα στο WooCommerce.

Βήμα 3: Χάρτης ρυθμίσεων

Βήμα 4: Reconcile-hold mode (προαιρετικό)

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

• Hold only: μόνο αναμονή και email, χωρίς αυτόματη ακύρωση.
• Hold + shadow reconcile: επιπλέον έλεγχος μέσω FOLLOW_UP και email με πρόταση, χωρίς καμία αυτόματη αλλαγή.
• Hold + auto-reconcile: η παραγγελία ολοκληρώνεται μόνο όταν η τράπεζα επιβεβαιώσει ότι πληρώθηκε. Όλες οι άλλες περιπτώσεις μένουν «Σε αναμονή» για χειροκίνητο έλεγχο.

Το FOLLOW_UP μόνο διαβάζει δεδομένα και δεν μπορεί να κινήσει χρήματα. Ξεκινήστε με «Hold + shadow reconcile», συγκρίνετε τα email με το AdminTool για λίγες μέρες και μετά περάστε σε «Hold + auto-reconcile». Η λειτουργία ενεργοποιείται όταν το WooCommerce ακυρώνει απλήρωτες παραγγελίες. Γι' αυτό χρειάζεται ενεργή διαχείριση αποθέματος και τιμή στο WooCommerce → Ρυθμίσεις → Προϊόντα → Απόθεμα → «Διατήρηση αποθέματος (λεπτά)».

Βήμα 5: Δοκιμή

Το plugin δεν έχει ξεχωριστό διακόπτη test mode. Για δοκιμές, περνάτε στα ίδια πεδία τα στοιχεία του Redirection Test Account της epay και ακολουθείτε τις οδηγίες δοκιμών της. Όταν λάβετε το Redirection Live Account, αντικαθιστάτε τα στοιχεία και κάνετε μια τελική συναλλαγή μικρής αξίας. Δοκιμάστε:

• Επιτυχή πληρωμή με κάρτα: η παραγγελία πηγαίνει σε «Σε επεξεργασία» (ή «Σε αναμονή» με Pre-Authorize) και καταγράφονται Transaction ID και SupportReferenceID.
• Απορριφθείσα και ακυρωμένη πληρωμή: η παραγγελία δεν σημειώνεται πληρωμένη και ο πελάτης επιστρέφει στο checkout.
• Πληρωμή IRIS, αν είναι ενεργή στη σύμβασή σας.
• Επιλογή δόσεων σε κλασικό και Blocks checkout.
• Μερική επιστροφή χρημάτων από το WooCommerce και έλεγχο στο AdminTool.

Go-live checklist

• Τα URLs επιτυχίας, αποτυχίας και ακύρωσης και η IP του server έχουν δηλωθεί στην τράπεζα.
• Τα URLs /wc-api/OBS_Piraeusbank_Gateway εξαιρούνται από cache και WAF.
• Το Pre-Authorize είναι ρυθμισμένο όπως θέλετε (αγορά ή προ-έγκριση).
• Τα Max Installments και η κλίμακα αντιστοιχούν στις δόσεις που έχει εγκρίνει η τράπεζα.
• Το Debug logging είναι απενεργοποιημένο στην παραγωγή.
• Έχετε αποφασίσει για το Reconcile-hold mode και έχετε ορίσει email ειδοποιήσεων.
• Μια πραγματική συναλλαγή μικρής αξίας συμφωνεί με το AdminTool (ποσό, παραγγελία, κατάσταση).

Αντιμετώπιση προβλημάτων

• Σύμπτωμα: Ο πελάτης πλήρωσε (ή χρεώθηκε περισσότερες από μία φορές), αλλά η παραγγελία έμεινε «Εκκρεμεί πληρωμή» ή ακυρώθηκε αυτόματα.
  Αιτία: Η απάντηση της τράπεζας δεν έφτασε στο eshop: έκλεισε ο browser, την έκοψε cache ή firewall, ή η τράπεζα άργησε. Αν ο πελάτης δεν δει επιβεβαίωση, συχνά ξαναπληρώνει.
  Λύση: Ελέγξτε τη συναλλαγή στο AdminTool (MerchantReference με τον αριθμό της παραγγελίας), ενημερώστε χειροκίνητα την παραγγελία και επιστρέψτε τυχόν διπλές χρεώσεις. Εξαιρέστε τα URLs /wc-api/OBS_Piraeusbank_Gateway από cache και WAF και ενεργοποιήστε το Reconcile-hold mode.
• Σύμπτωμα: Η τράπεζα χρέωσε την κάρτα, αλλά η παραγγελία σημειώθηκε «Απέτυχε».
  Αιτία: Σε εκδόσεις πριν την 4.3.3, η ανανέωση της σελίδας δημιουργούσε δεύτερο transaction ticket και η απάντηση ελεγχόταν με λάθος ticket.
  Λύση: Ενημερώστε στην τελευταία έκδοση και διορθώστε την παραγγελία αφού επιβεβαιώσετε τη συναλλαγή στο AdminTool.
• Σύμπτωμα: Μετά από πληρωμή IRIS ο πελάτης επιστρέφει σε κενή σελίδα ή η παραγγελία ακυρώνεται, ενώ τα χρήματα έχουν χρεωθεί.
  Αιτία: Εκδόσεις πριν την 4.3.5 απαιτούσαν πεδία που η τράπεζα στέλνει μόνο για πληρωμές με κάρτα, οπότε η απάντηση IRIS απορριπτόταν.
  Λύση: Ενημερώστε το plugin, εξαιρέστε τα URLs επιστροφής από cache και ενημερώστε χειροκίνητα την παραγγελία αφού ελέγξετε το AdminTool.
• Σύμπτωμα: Το Reconcile-hold mode είναι ενεργό, αλλά οι εκκρεμείς παραγγελίες δεν ελέγχονται.
  Αιτία: Το Reconcile-hold mode λειτουργεί όταν το WooCommerce ακυρώνει αυτόματα απλήρωτες παραγγελίες, πράγμα που γίνεται μόνο αν είναι ενεργή η διαχείριση αποθέματος και ορισμένη η «Διατήρηση αποθέματος (λεπτά)».
  Λύση: Ορίστε «Διατήρηση αποθέματος (λεπτά)» στο WooCommerce → Ρυθμίσεις → Προϊόντα → Απόθεμα. Μέχρι τότε, ελέγχετε τις εκκρεμείς παραγγελίες στο AdminTool ή ζητήστε βοήθεια από την OBS.
• Σύμπτωμα: Στο checkout εμφανίζεται «Result code is 1041» ή «Invalid IP address».
  Αιτία: Η IP που έχει δηλωθεί στην τράπεζα δεν είναι αυτή με την οποία συνδέεται ο server σας. Σε shared hosting η εξερχόμενη IP μπορεί να διαφέρει από την IP του site.
  Λύση: Επιβεβαιώστε την εξερχόμενη IP με την εταιρεία φιλοξενίας και στείλτε τη στην epay. Αν η φιλοξενία δεν έχει σταθερή IP, ορίστε HTTP proxy με σταθερή IP.
• Σύμπτωμα: Στο checkout εμφανίζεται «Result code is 100».
  Αιτία: Το Username ή το Password στις ρυθμίσεις δεν είναι σωστό, π.χ. μετά από αλλαγή κωδικού από την epay.
  Λύση: Πληκτρολογήστε ξανά τα στοιχεία ακριβώς όπως τα έστειλε η epay, χωρίς κενά στην αρχή ή στο τέλος.
• Σύμπτωμα: Ο πελάτης δεν μεταφέρεται στην τράπεζα: μένει στο μήνυμα ανακατεύθυνσης ή βλέπει ενδιάμεση σελίδα με κουμπιά πληρωμής και ακύρωσης.
  Αιτία: Το script που στέλνει αυτόματα τη φόρμα στην τράπεζα δεν εκτελείται. Παλαιότερες εκδόσεις χρησιμοποιούσαν μηχανισμό JavaScript που καταργήθηκε στο WooCommerce 10.4, ή κάποιο plugin βελτιστοποίησης ή cache καθυστερεί τα inline scripts. Τότε μένουν ορατά τα εφεδρικά κουμπιά της φόρμας.
  Λύση: Ενημερώστε στην τελευταία έκδοση και εξαιρέστε τη σελίδα πληρωμής παραγγελίας από defer/combine JavaScript και από cache.
• Σύμπτωμα: Ο πελάτης επιλέγει δόσεις, αλλά η τράπεζα χρεώνει εφάπαξ ή δεν εμφανίζονται δόσεις.
  Αιτία: Το ποσό της παραγγελίας είναι κάτω από το όριο της κλίμακας ποσού:δόσεων, το «Max Installments» είναι 1, οι δόσεις δεν έχουν ενεργοποιηθεί από την τράπεζα, ή πρόκειται για σφάλμα παλαιότερων εκδόσεων που έστελναν πάντα 1 δόση.
  Λύση: Ελέγξτε το «Max Installments» και την κλίμακα (η κλίμακα δεν ξεπερνά ποτέ το μέγιστο), επιβεβαιώστε με την τράπεζα ότι οι δόσεις είναι ενεργές και ενημερώστε το plugin.
• Σύμπτωμα: Οι πληρωμένες παραγγελίες μένουν «Σε αναμονή».
  Αιτία: Είναι ενεργή η ρύθμιση Pre-Authorize (Προ-Έγκριση), που είναι και η προεπιλογή. Η τράπεζα μόνο δεσμεύει το ποσό.
  Λύση: Κάντε εκκαθάριση της προ-έγκρισης από το AdminTool ή απενεργοποιήστε το Pre-Authorize για άμεση χρέωση (Purchase).
• Σύμπτωμα: Δεν εμφανίζονται Apple Pay ή Google Pay στη σελίδα πληρωμής.
  Αιτία: Οι μέθοδοι αυτές ενεργοποιούνται από την epay στον λογαριασμό σας, όχι από το plugin.
  Λύση: Ζητήστε την ενεργοποίηση από την epay. Μόλις ενεργοποιηθούν, εμφανίζονται στη σελίδα πληρωμής της τράπεζας χωρίς αλλαγή στο WooCommerce.
• Σύμπτωμα: Εμφανίζεται «Soap extension is not enabled on your server» ή «SOAP-ERROR: Parsing WSDL».
  Αιτία: Ο server δεν έχει ενεργό το PHP SOAP extension ή δεν μπορεί να συνδεθεί με το Paycenter της τράπεζας.
  Λύση: Ζητήστε από την εταιρεία φιλοξενίας να ενεργοποιήσει το SOAP και να επιτρέπει εξερχόμενες συνδέσεις HTTPS. Μετά ζητήστε από την τράπεζα νέο έλεγχο σύνδεσης.
• Σύμπτωμα: Το κουμπί επιστροφής χρημάτων εμφανίζει μήνυμα για IRIS ή για προ-έγκριση.
  Αιτία: Οι αυτόματες επιστροφές γίνονται μόνο για πληρωμές με κάρτα σε EUR που ολοκληρώθηκαν ως αγορά.
  Λύση: Κάντε την επιστροφή ή την ακύρωση από το Paycenter AdminTool και προσθέστε σημείωση στην παραγγελία.
• Σύμπτωμα: Μήνυμα «duplicate transaction references are not allowed» (κωδικός 1045).
  Αιτία: Παλαιότερες εκδόσεις έστελναν ξανά το ίδιο MerchantReference όταν ο πελάτης ξαναδοκίμαζε.
  Λύση: Ενημερώστε το plugin. Οι νέες εκδόσεις δημιουργούν μοναδική αναφορά σε κάθε απόπειρα.
• Σύμπτωμα: Αυξημένη κατανάλωση μνήμης ή αργή σελίδα ρυθμίσεων.
  Αιτία: Παλαιότερες εκδόσεις φόρτωναν τη βιβλιοθήκη ενημερώσεων σε κάθε σελίδα και είχαν αργό ερώτημα για τη λίστα σελίδων.
  Λύση: Ενημερώστε στην τελευταία έκδοση.

Για συμβατότητα εκδόσεων δείτε τη σελίδα συμβατότητας WooCommerce. Αν το πρόβλημα παραμένει, ανοίξτε ticket στην OBS. Μη στέλνετε κωδικούς ή στοιχεία καρτών.