ePay Paycenter για το WooCommerce
ePay Paycenter για το WooCommerce
Δεχθείτε πιστωτικές ή χρεωστικές κάρτες μέσω της ασφαλούς υπηρεσίας Redirection της Τράπεζας Πειραιώς / Euronet Merchant Services.
Το ePay Paycenter για το WooCommerce είναι το payment module του ηλεκτρονικού καταστήματός μας για πληρωμές με κάρτα μέσω της υπηρεσίας ePay Paycenter Redirection της Τράπεζας Πειραιώς / Euronet Merchant Services.
Ο πελάτης επιλέγει την πληρωμή με κάρτα στο checkout, μεταφέρεται στην ασφαλή σελίδα πληρωμής της τράπεζας, ολοκληρώνει τη συναλλαγή (με 3D Secure όπου απαιτείται) και επιστρέφει αυτόματα στο κατάστημα με την παραγγελία του ενημερωμένη. Τα στοιχεία της κάρτας δεν περνούν ποτέ από τον server του καταστήματος.
Γιατί να το επιλέξετε
- Ασφαλής πληρωμή μέσω τράπεζας. Η συναλλαγή γίνεται εξ ολοκλήρου στη σελίδα της Τράπεζας Πειραιώς / Euronet. Το κατάστημα δεν αποθηκεύει και δεν επεξεργάζεται αριθμούς καρτών.
- Κάρτες και IRIS. Υποστηρίζονται πιστωτικές και χρεωστικές κάρτες, καθώς και πληρωμές IRIS όταν η υπηρεσία είναι ενεργοποιημένη στη σύμβαση του εμπόρου.
- Δόσεις. Προαιρετικά, προσφέρονται άτοκες δόσεις ανάλογα με το ποσό της παραγγελίας, εφόσον το επιτρέπει η σύμβαση με την τράπεζα.
- Σύγχρονο checkout. Υποστηρίζονται τόσο το κλασικό checkout όσο και το WooCommerce Blocks Checkout, καθώς και HPOS (High-Performance Order Storage).
- Πλήρης παρακολούθηση. Καταγραφή κάθε callback, έλεγχος γνησιότητας με HMAC-SHA256, ενσωματωμένο διαγνωστικό ελέγχου της διεύθυνσης callback και ειδική μέριμνα για Cloudflare / WAF.
- Ελληνική και αγγλική σελίδα πληρωμής. Η γλώσσα της σελίδας πληρωμής επιλέγεται από τις ρυθμίσεις (Ελληνικά, Αγγλικά, Ρωσικά, Γερμανικά).
Τι χρειάζεστε από την τράπεζα
Για την ενεργοποίηση του module αρκεί να ζητήσετε από την Euronet Merchant Services / Τράπεζα Πειραιώς τα παρακάτω στοιχεία του εμπορικού σας λογαριασμού:
| Στοιχείο | Περιγραφή |
|---|---|
| Περιβάλλον | Παραγωγικός Λογαριασμός (για πραγματικές πληρωμές). Οι δοκιμαστικοί και οι παραγωγικοί λογαριασμοί έχουν διαφορετικά διαπιστευτήρια. |
| Acquirer ID | Αριθμητικό αναγνωριστικό acquirer. |
| Merchant ID | Αριθμητικό αναγνωριστικό εμπόρου. |
| POS ID | Αριθμητικό αναγνωριστικό POS. |
| Όνομα χρήστη | Username για το Ticketing Web Service (έως 50 χαρακτήρες). |
| Κωδικός πρόσβασης | Password για το Ticketing Web Service. Καταχωρείται σε απλό κείμενο και μετατρέπεται αυτόματα σε MD5 hash πριν σταλεί στο Paycenter. |
Δεν χρειάζεται να ζητήσετε ή να ρυθμίσετε τίποτα άλλο από πλευράς κώδικα. Τα υπόλοιπα στοιχεία (διευθύνσεις callback, IP, τρόπος απόκρισης) παράγονται αυτόματα από το module και εμφανίζονται έτοιμα προς αντιγραφή στη σελίδα ρυθμίσεων.
Ρυθμίσεις στο WooCommerce
Μεταβείτε στο WooCommerce → Ρυθμίσεις → Πληρωμές → ePay Paycenter και συμπληρώστε:
Γενικά
| Ρύθμιση | Προτεινόμενη τιμή |
|---|---|
| Ενεργοποίηση | Ενεργό |
| Τίτλος | Πιστωτική / Χρεωστική Κάρτα (Τράπεζα Πειραιώς) |
| Περιγραφή | Το κείμενο που βλέπει ο πελάτης στο checkout. Προεπιλογή: ασφαλής πληρωμή με κάρτα μέσω της σελίδας της Τράπεζας Πειραιώς. |
Διαπιστευτήρια εμπόρου
| Ρύθμιση | Τιμή |
|---|---|
| Περιβάλλον | Παραγωγικός Λογαριασμός (για live πληρωμές) |
| Acquirer ID | Από την τράπεζα |
| Merchant ID | Από την τράπεζα |
| POS ID | Από την τράπεζα |
| Όνομα χρήστη | Από την τράπεζα |
| Κωδικός πρόσβασης | Από την τράπεζα |
Συμπεριφορά πληρωμής
| Ρύθμιση | Προτεινόμενη τιμή | Σημείωση |
|---|---|---|
| Τύπος συναλλαγής | Πώληση (άμεση χρέωση) | Η χρέωση ολοκληρώνεται αμέσως. Η «Προέγκριση» απαιτεί ενεργοποίηση από την Euronet Merchant Services. |
| Λήξη προέγκρισης (ημέρες) | 7 | Ισχύει μόνο για συναλλαγές Προέγκρισης. Αγνοείται όταν ο τύπος είναι «Πώληση». |
| Γλώσσα σελίδας πληρωμής | Ελληνικά (el-GR) | Εναλλακτικά Αγγλικά, Ρωσικά ή Γερμανικά. |
Δόσεις (προαιρετικά)
Ενεργοποιήστε το Installments support μόνο εφόσον η τράπεζα έχει ενεργοποιήσει δόσεις στη σύμβασή σας. Μπορείτε να ορίσετε μέγιστο αριθμό δόσεων, ελάχιστο ποσό παραγγελίας και κλιμακωτό όριο ανά ποσό (π.χ. 50:3, 100:6, 200:12). Οι δόσεις είναι άτοκες για τον πελάτη και η προμήθεια βαρύνει τον έμπορο.
Ολοκλήρωση
Πατήστε Αποθήκευση αλλαγών και στη συνέχεια Δοκιμή διεύθυνσης callback. Η δοκιμή ελέγχει αν το callback φτάνει στον server μας και αν κάποιο firewall του hosting (ModSecurity, cPFence, Imunify360, BitNinja, LiteSpeed) το μπλοκάρει.
Στοιχεία που ζητά η τράπεζα
Στην ίδια σελίδα ρυθμίσεων, η κάρτα Bank integration data εμφανίζει έτοιμες τις τιμές που χρειάζεται η Euronet Merchant Services:
| Πεδίο | Τιμή |
|---|---|
| Website URL | Το URL του καταστήματος |
| Referrer URL | Η σελίδα checkout που ξεκινά την πληρωμή |
| Success URL | /?wc-api=epay_paycenter |
| Failure URL | /?wc-api=epay_paycenter |
| Backlink URL | /?wc-api=epay_paycenter |
| IP address | Η διεύθυνση του server (επιβεβαιώστε με τον hosting provider την εξερχόμενη IP πίσω από proxy/CDN) |
| Response method | POST (προτείνεται — υποστηρίζεται και GET) |
Χρησιμοποιήστε το κουμπί Copy για να αντιγράψετε όλες τις διευθύνσεις callback και να τις δηλώσετε στο portal της Euronet.
Σημαντικό: Η διεύθυνση callback πρέπει να καταχωρηθεί στο portal της τράπεζας ως πλήρες URL με το domain του καταστήματος και κατάληξη ακριβώς
/?wc-api=epay_paycenter(ή/wc-api/epay_paycenter/). Αν καταχωρηθεί διαφορετική διεύθυνση, οι πληρωμές μπορεί να χρεώνονται αλλά οι παραγγελίες να μην ενημερώνονται αυτόματα.
Πώς λειτουργεί η πληρωμή
- Ο πελάτης επιλέγει Πιστωτική / Χρεωστική Κάρτα (Τράπεζα Πειραιώς) στο checkout.
- Η παραγγελία δημιουργείται σε κατάσταση Pending payment και ο πελάτης μεταφέρεται στη σελίδα πληρωμής της παραγγελίας.
- Το module ζητά TranTicket από το Paycenter Ticketing Web Service (SOAP).
- Το κατάστημα υποβάλλει αυτόματα τη φόρμα σύνδεσης στη σελίδα Redirection της τράπεζας.
- Ο πελάτης πληρώνει στην ασφαλή σελίδα της Τράπεζας Πειραιώς / Euronet (κάρτα ή IRIS).
- Η τράπεζα στέλνει την απόκριση στο
/?wc-api=epay_paycenter. - Το module επαληθεύει την απόκριση με HMAC-SHA256 HashKey, ελέγχει ότι το
MerchantReferenceανήκει στην παραγγελία και: - σε επιτυχία, ολοκληρώνει την παραγγελία (Completed / Processing ανάλογα με τα προϊόντα) και αδειάζει το καλάθι,
- σε αποτυχία, θέτει την παραγγελία σε Failed και εμφανίζει μήνυμα στον πελάτη στη σελίδα επαναπληρωμής.
- Αν ο πελάτης πατήσει Cancel στη σελίδα της τράπεζας, επιστρέφει με ασφαλές token και μπορεί να δοκιμάσει ξανά την πληρωμή.
Τεχνική υλοποίηση
Endpoints
- Ticketing (SOAP):
https://paycenter.piraeusbank.gr/services/tickets/issuer.asmx - Redirection (payment page):
https://paycenter.piraeusbank.gr/redirection/pay.aspx - Callback:
/?wc-api=epay_paycenter
Ασφάλεια
- Καμία αποθήκευση στοιχείων κάρτας στον server του καταστήματος.
- HMAC-SHA256 HashKey σε κάθε επιτυχημένη απόκριση, με τα πεδία που ορίζει η προδιαγραφή Redirection v2.9.
- Έλεγχος ότι το
MerchantReferenceαντιστοιχεί στην παραγγελία και ότι η παραγγελία χρησιμοποιεί το συγκεκριμένο gateway. - Idempotency: επαναλαμβανόμενα callbacks σε ήδη πληρωμένη παραγγελία αγνοούνται.
- Cancel token μίας χρήσης για την επιστροφή από το κουμπί Cancel.
- Το
TranTicketδιαγράφεται από τα meta μετά την επαλήθευση και διατηρείται μόνο ως SHA-256 digest στον πίνακα{prefix}epay_paycenter_tickets. - Προαιρετικό IP allowlist μέσω του filter
epay_paycenter_allowed_callback_ips(υποστηρίζειCF-Connecting-IPπίσω από Cloudflare). - Οι κωδικοί δεν καταγράφονται ποτέ στα logs.
Δεδομένα παραγγελίας
Αποθηκεύονται ως order meta, μεταξύ άλλων:
_epay_merchant_reference, _epay_tran_ticket, _epay_cancel_token, _epay_result_code, _epay_result_description, _epay_response_code, _epay_response_description, _epay_status_flag, _epay_transaction_id, _epay_auth_status, _epay_approval_code, _epay_package_no, _epay_trace_id, _epay_support_reference_id, _epay_card_type, _epay_payment_method, _epay_installments, _epay_last_callback_at.
Απαιτήσεις
- WordPress 6.3+
- WooCommerce 7.0+ (δοκιμασμένο έως 9.5)
- PHP 7.4+
- Ενεργή σύμβαση ePay Paycenter Redirection με Euronet Merchant Services / Τράπεζα Πειραιώς
Αντιμετώπιση προβλημάτων
| Σύμπτωμα | Έλεγχος |
|---|---|
| Η πληρωμή χρεώνεται αλλά η παραγγελία μένει Pending | Ελέγξτε ότι στο portal της τράπεζας οι Success / Failure / Backlink URLs είναι ακριβώς /?wc-api=epay_paycenter. |
| Το callback δεν φτάνει ποτέ | Πατήστε Δοκιμή διεύθυνσης callback. Αν αποτύχει, ζητήστε από τον hosting provider να επιτρέψει τη διεύθυνση callback (WAF / ModSecurity / cPFence / Imunify360 / BitNinja / LiteSpeed). |
| Χρήση Cloudflare | Η σελίδα ρυθμίσεων εμφανίζει τις τρέχουσες Cloudflare IPv4 ranges. Δώστε τις στην Euronet ώστε να μην μπλοκάρονται τα callbacks. |
| Παραγγελία σε On hold μετά από επιτυχημένη πληρωμή | Αποτυχία επαλήθευσης HashKey. Ελέγξτε τα credentials και τα logs epay-paycenter. Απαιτείται χειροκίνητος έλεγχος πριν την εκτέλεση. |
Κενή σελίδα ή -1 μετά την πληρωμή | Ελέγξτε αν υπάρχει καταγραφή callback στα logs. Αν δεν υπάρχει, το POST δεν έφτασε στην PHP (WAF ή λάθος URL). |
| Αποτυχία έκδοσης ticket | Ελέγξτε Acquirer ID, Merchant ID, POS ID, username/password και αν το περιβάλλον είναι σωστό (Test / Παραγωγικός). |
Ενεργοποιήστε το Logging για αναλυτική καταγραφή στο WooCommerce → Status → Logs, με πηγή epay-paycenter.
Σημειώσεις
- Οι επιστροφές χρημάτων (refunds) δεν εκτελούνται από το WooCommerce με αυτό το module· πραγματοποιούνται από το back-office της Τράπεζας Πειραιώς / Euronet.
- Οι πληρωμές IRIS δεν υποστηρίζουν δόσεις ούτε επιστροφές.
- Η Λήξη προέγκρισης αγνοείται όταν ο τύπος συναλλαγής είναι Πώληση (άμεση χρέωση).
- Τα διαπιστευτήρια Test και Παραγωγικού λογαριασμού είναι διαφορετικά. Μην τα αντιγράφετε μεταξύ περιβαλλόντων.
Θέλετε να το εγκαταστήσουμε εμείς;
Μπορούμε να σας το εγκαταστήσουμε και να ρυθμίσουμε, ή να το προσαρμόσουμε στις ανάγκες του καταστήματός σας.