Piraeus Bank – Epay – Redirection
Οδηγός σύνδεσης της Τράπεζας Πειραιώς με Epay για online πληρωμές.
Αυτός ο οδηγός θα σας βοηθήσει να ενεργοποιήσετε πληρωμές με κάρτες μέσω της Τράπεζας Πειραιώς στην ιστοσελίδα σας, χρησιμοποιώντας το σύστημα Epay – Redirection.
Στον οδηγό που ακολουθεί θα δείτε, βήμα προς βήμα:
- Πώς να ενεργοποιήσετε λογαριασμό στην Πειραιώς για online πληρωμές
- Πώς να στείλετε τα σωστά στοιχεία στην Epay
- Πώς να ρυθμίσετε το site σας για δοκιμαστικές πληρωμές
- Πώς να περάσετε τα απαιτούμενα test cases με δοκιμαστικές κάρτες
- Και πώς να ενεργοποιήσετε το σύστημα για πραγματικές πληρωμές με κάρτα
Δεν απαιτούνται τεχνικές γνώσεις — αρκεί να ακολουθήσετε τα βήματα όπως τα περιγράφουμε.
Τι πρέπει να έχετε πριν ξεκινήσετε #
Τι πρέπει να έχετε έτοιμο #
- Πρόσβαση στο διαχειριστικό περιβάλλον της ιστοσελίδας σας (admin panel).
- Εύκαιρο το ΑΦΜ σας.
- Πρόσβαση στο email επικοινωνίας της επιχείρησης.
- Την IP του server σας (θα τη λάβετε από την τεχνική μας ομάδα).
💡 TIP: Καλό είναι να έχετε ανοιχτές δύο καρτέλες στον browser σας, ώστε να εργάζεστε πιο εύκολα:
- Μία με το διαχειριστικό της ιστοσελίδας.
- Μία με το email της επιχείρησης.
Έτσι, θα μπορείτε να κάνετε εύκολα αντιγραφή/επικόλληση μεταξύ των δύο.
Ξεκινάμε με την Τράπεζα Πειραιώς και Epay #
Ενεργοποίηση λογαριασμού για online πληρωμές μέσω Epay #
🔑 Τι κάνετε εδώ:
Πριν ξεκινήσει η διαδικασία, πρέπει να επικοινωνήσετε με την Τράπεζα Πειραιώς και να ζητήσετε ενεργοποίηση λογαριασμού για online πληρωμές μέσω Epay (Redirection).
Η τράπεζα μπορεί να σας καθοδηγήσει ώστε να συμπληρώσετε τα απαραίτητα έγγραφα.
Μόλις ολοκληρώσετε αυτό το στάδιο, είναι απαραίτητο να στείλετε email στην ομάδα της Epay.
Αποστολή στοιχείων στην Epay #
Στέλνετε email στην Epay #
🔑 Τι κάνετε εδώ:
Στέλνετε email στην Epay για να ζητήσετε δοκιμαστικό λογαριασμό.
📧 Αποστολή στο: onlineservices@epayworldwide.gr
Στο email συμπεριλάβετε τα εξής στοιχεία:
To Web site URL #
Είναι η βασική διεύθυνση της ιστοσελίδας σας, π.χ.:
https://mysite.com
📌 Π.χ. αν το site σας είναι https://www.myhotel.gr, τότε το γράφετε αυτούσιο.
To Referrer URL #
Είναι η σελίδα στην οποία ξεκινά η κράτηση. Π.χ.:
https://mysite.com/booking-page-url
Ουσιαστικά είναι το domain mysite.com + η σελίδα όπου των κρατήσεις /booking-page-url/
💡 Πώς βρίσκω το Referrer URL:
Μπείτε στο WordPress → Σελίδες → Βρείτε τη σελίδα κρατήσεων → Δείτε το permalink (slug).
Αν η σελίδα έχει διεύθυνση https://www.myhotel.gr/booking-page, τότε αυτό είναι το σωστό URL.

Tα Success / Failure / Backlink URLs #
Είναι οι σελίδες που επιστρέφει ο χρήστης μετά την πληρωμή. Η μορφή τους είναι:
Success URL:
https://mysite.com + /reservation-overview-page-url/ + ?bookingid=$id&payment_method=piraeus&lang=$lang&status=success
Όλο μαζί θα μοιάζει κάπως έτσι:
https://mysite.com/reservation-overview-page-url/?bookingid=$id&payment_method=piraeus&lang=$lang&status=success
Failure URL:
https://mysite.com + /reservation-overview-page-url/ + ?bookingid=$id&payment_method=piraeus&lang=$lang&status=cancel
Όλο μαζί θα μοιάζει κάπως έτσι:
https://mysite.com/reservation-overview-page-url/?bookingid=$id&payment_method=piraeus&lang=$lang&status=cancel
Backlink URL:
https://mysite.com + /reservation-overview-page-url/ + ?bookingid=$id&payment_method=piraeus&lang=$lang&status=cancel
Όλο μαζί θα μοιάζει κάπως έτσι:
https://mysite.com/reservation-overview-page-url/?bookingid=$id&payment_method=piraeus&lang=$lang&status=cancel
Ας κάνουμε μια παύση για να δούμε τι βλέπουμε! 🧘♂️
- Το https://mysite.com είναι το domain του site.
- Το /reservation-overview-page-url/ είναι το slug της σελίδας που εμφανίζει τη σύνοψη της κράτησης.
💡Πώς το βρίσκω; 🤷🏻♂️
Μπείτε στο WordPress → Σελίδες → Βρείτε τη σελίδα με τη σύνοψη της κράτησης (Review Page) → Δείτε το permalink (slug). Π.χ. αν είναι https://www.myhotel.gr/booking-summary, τότε χρησιμοποιείτε αυτό το URL.
👉 PRO TIP:
Το κομμάτι μετά το ? παραμένει αυτούσιο. Άρα, απλώς κάνετε ένα copy-paste και τελειώσατε! 😎
Επίσης: #
Το email πρέπει επίσης να περιλαμβάνει τα εξής στοιχεία:
- Μέθοδος απάντησης (GET ή POST) : POST
- IP του server σας (θα σας την δώσει η τεχνική μας ομάδα)
- ΑΦΜ της επιχείρησης
🚨Προσοχή:
Αν η ιστοσελίδα σας είναι σε πολλές γλώσσες (π.χ. Αγγλικά + Ελληνικά), θα πρέπει να στείλετε τα παραπάνω URLs για κάθε γλωσσική εκδοχή.
Π.Χ. :
- Αγγλικά: https://mysite.com/booking-page-url
- Ελληνικά: https://mysite.com/el/booking-page-url
(Αν αντιμετωπίζετε δυσκολία για να εντοπίσετε τις αντίστοιχες σελίδες στα Ελληνικά, δείτε τον σχετικό οδηγό μας.)
🧘♂️ Ωραία, στείλατε το email; Πάμε στο επόμενο βήμα μόλις σας απαντήσουν με τα test στοιχεία, ξεκινάμε τις ρυθμίσεις στην ιστοσελίδα! 🚀
Παραλαβή δοκιμαστικών στοιχείων Epay #
🔑 Τι συμβαίνει εδώ:
Αφού στείλετε τα απαραίτητα στοιχεία στην Epay, η ομάδα τους θα σας απαντήσει με:
- Τα δοκιμαστικά credentials (Merchant ID, POS ID, Acquirer ID κ.λπ.).
- Ένα έγγραφο PDF που περιέχει όλες τις απαραίτητες οδηγίες και σενάρια δοκιμών.
ε αυτό το έγγραφο θα βρείτε και δοκιμαστικούς αριθμούς καρτών, καθώς και τα βήματα που πρέπει να ακολουθήσετε για να ολοκληρώσετε επιτυχώς τις δοκιμές.
💡 Ποιος είναι ο στόχος αυτών των δοκιμών;
Ουσιαστικά, αυτό που κάνουμε είναι να διασυνδέσουμε το site με το σύστημα Epay – Redirection, ώστε:
- Οι πελάτες να μπορούν να ολοκληρώνουν αγορές με κάρτα, μέσα από το site.
- Ο κάτοχος της ιστοσελίδας λαμβάνει τα χρήματα κατευθείαν από στην Τράπεζα Πειραιώς.
📌 Μόλις περάσετε με επιτυχία τα test σενάρια, η τράπεζα σάς στέλνει τα κανονικά στοιχεία για να ξεκινήσετε τις πραγματικές πληρωμές.
Δοκιμαστικά στοιχεία στο site #
🔑 Τι κάνετε εδώ:
Αυτό είναι το σημείο όπου συνδέετε το site σας με το σύστημα πληρωμών της Πειραιώς μέσω Epay – Redirection.
📍 Χρησιμοποιείτε τα δοκιμαστικά στοιχεία που σας έστειλε η τράπεζα (Merchant ID, POS ID κ.λπ.) προσωρινά, μόνο για να εκτελέσετε τις πρώτες δοκιμές. Όταν όλα δουλέψουν σωστά, θα τα αντικαταστήσετε με τα κανονικά (live) στοιχεία.
🛠️ Βήματα:
- Πρώτα, συνδεθείτε στο WordPress admin
- Πηγαίνετε στο Bookings → Gateway Settings
- Επιλέξτε Piraeus
- Επιλέγετε το “Add Row” και εισάγετε:
- Merchant ID
- POS ID
- Acquirer ID
- Username
- Password
- Language
- Language: Επιλέξτε μια γλώσσα. Αν το site σας έχει πολλές γλώσσες, απλώς επιλέξτε “Add Row” και την κάθε γλώσσα ξεχωριστά. Κάντε το όσες φορές χρειάζεται για να καλύψετε όλες.
- Προσθέτετε το αποδεκτό εικονίδιο της τράπεζας*
- Redirect Message: Το μήνυμα που θα βλέπει ο πελάτης όταν μεταβαίνει στο περιβάλλον πληρωμής.
Π.χ.: You are being redirected to epay secure environment… - Enable Test Environment: Τσεκάρετε το κουτάκι για να κάνετε δοκιμές.
- Display Title: Το όνομα της μεθόδου πληρωμής που βλέπει ο πελάτης.
Π.χ.: Credit/Debit card secure payment - Display Instruction: Σύντομη περιγραφή κάτω από τον τρόπο πληρωμής που θα βλέπει ο πελάτης.
Π.χ.: Pay securely using your credit/debit card - Τέλος, επιλέξτε Save Changes

🔧 Το έστησες! Το σύστημα είναι σχεδόν έτοιμο. Είσαι πιο κοντά από όσο νομίζεις. 💪
Δημιουργία δοκιμαστικής κράτησης #
Δημιουργία δοκιμαστικού προϊόντος #
🔑 Τι κάνετε εδώ:
Εκτελείτε μια δοκιμαστική συναλλαγή για να ελέγξετε ότι η ρύθμιση έχει γίνει σωστά. Σκεφτείτε ότι: “Αν ήμουν κανονικός πελάτης, θα μπορούσα να πληρώσω;”. Με αυτό το βήμα, επιβεβαιώνετε ότι η σύνδεση ανάμεσα στην ιστοσελίδα και το epay λειτουργεί όπως πρέπει.
Από το διαχειριστικό της ιστοσελίδας πηγαίνετε εκεί που προσθέτετε κρατήσεις (Accommodation, Travel κ.λπ.).
📌 Σημείωση:
Αν δεν γνωρίζετε πού ακριβώς είναι αυτή η ρύθμιση, ανατρέξτε στον σχετικό οδηγό της πλατφόρμας σας.
- Αρχικά, δημιουργείτε ένα νέο αντικείμενο με όνομα “Test”.
- Και στην συνέχεια, βάλτε διαθεσιμότητα για 2–3 μέρες με τιμή 0.01 €.
📌 Σημείωση: Η τιμή δεν πρέπει να ξεπερνάει τα 0.10 € και πρέπει να περιλαμβάνει τελεία ” . ” .


Πληρωμή δοκιμαστικής κράτησης #
🔑 Τι κάνετε εδώ:
Ανοίξτε το έγγραφο PDF που σας έστειλε η Epay μαζί με τα δοκιμαστικά στοιχεία.
Στο κεφάλαιο με τίτλο “Test Cases” θα βρείτε όλα τα σενάρια που πρέπει να εκτελέσετε.
Για κάθε σενάριο, η Epay γράφει ξεκάθαρα αν η συναλλαγή πρέπει να ολοκληρωθεί με επιτυχία ή να αποτύχει. Με αυτόν τον τρόπο, η τράπεζα ελέγχει αν το σύστημα σας χειρίζεται σωστά και τις δύο περιπτώσεις.
📍Μόνο τα στοιχεία των καρτών που για “Αγορά (Purchase)” ειναι απαρέτητα — όχι για προέγκριση ή άλλες λειτουργίες.
⚠️ Προσοχή:
Εκτελείτε τα 10 σενάρια που έχει συμπεριλάβει η Epay στο έγγραφο. Αν παραλείψετε κάποιο, η τράπεζα δεν θα θεωρήσει τις δοκιμές έγκυρες.
🚨TIP:
Case 9: Η δοκιμή περνάει μόνο αν η συναλλαγή γίνει με δόσεις.
🚨🚨TIP:
Case 10: Στο τέλος της συναλλαγής, ειπάρχει ένα βήμα επιβεβαίωσης.
Πρέπει να πατήσετε “Yes” για να προχωρήσει η διαδικασία. Αν επιλέξετε “No” ή κλείσετε το παράθυρο, η δοκιμή αποτυγχάνει.

🎯 10 στα 10! Αν πέρασες όλα τα σενάρια, μπράβο σου — οι πληρωμές είναι προ των πυλών! 🥳
Ενημέρωση Epay για ολοκλήρωση των δοκιμών #
Αφού έχετε τρέξει όλα τα σενάρια είναι και είναι OK, στέλνετε ξανά email στην Epay για να ζητήσετε τα παραγωγικά (live) credentials.
⚠️ Προσοχή!
Πριν ενημερώσετε την τράπεζα, βεβαιωθείτε ότι στο footer του site υπάρχει το σωστό λογότυπο πληρωμών (Visa, Mastercard κ.λπ.), όπως ζητείται από την Πειραιώς.
💡 Αν δεν ξέρετε πώς να το αλλάξετε, δείτε τον σχετικό οδηγό μας.
Στο email περιλαμβάνετε ξανά:
- Web Site URL
- Referrer URL
- Success URL / Failure URL / Backlink URL
- IP διεύθυνση του server
- Email επικοινωνίας επιχείρησης
- ΑΦΜ επιχείρησης
📧 Email προς: onlineservices@epayworldwide.gr
Ενεργοποίηση και τελική δοκιμή #
Τελικό βήμα #
🔑 Τι κάνετε εδώ:
Μόλις λάβετε από την Epay τα παραγωγικά (live) credentials, ήρθε η στιγμή να ενεργοποιήσετε επίσημα το σύστημα πληρωμών στο site.
Αντικαθιστούμε τα δοκιμαστικά στοιχεία #
- Πρώτα, συνδεθείτε στο WordPress admin
- Πηγαίνετε στο Bookings → Gateway Settings
- Επιλέξτε Piraeus (Epay Redirection)
- Αντικαταστήστε τα δοκιμαστικά στοιχεία με τα κανονικά (live) credentials:
- Merchant ID
- POS ID
- Acquirer ID
- Username
- Password
- Πατήστε Save
Πραγματική δοκιμή πληρωμής #
- Πηγαίνετε στο δοκιμαστικό προϊόν (π.χ. “Test”) που δημιουργήσατε νωρίτερα
- Κάντε μια πραγματική κράτηση με πραγματική κάρτα.
- Ελέγξτε αν η πληρωμή ολοκληρώνεται σωστά.
🎉 Τα κατάφερες! Η ιστοσελίδα σου δέχεται πλέον πληρωμές με κάρτα. Πες το και σε φίλο σου. 😄