Οδηγός σύνδεσης της Τράπεζας Πειραιώς και Epay για online πληρωμές.
Αυτός ο οδηγός θα σε βοηθήσει να ρυθμίσεις τις πληρωμές με κάρτα, έχοντας ως τράπεζα διασύνδεσης την Τράπεζα Πειραιώς. Θα χρησιμοποιήσεις το σύστημα Epay – Redirection.
Στον οδηγό που ακολουθεί θα δεις, βήμα προς βήμα:
- Πώς να επικοινωνίσεις με την Τράπεζα Πειραιώς για online πληρωμές.
- Πώς να ρυθμίσεις τα σωστά στοιχεία στην Epay.
- Πώς να κάνεις τις ρυθμίσεις το site σου για δοκιμαστικές πληρωμές.
- Πώς να περάσεις τα απαιτούμενα test.
Δεν απαιτούνται τεχνικές γνώσεις — αρκεί να ακολουθήσεις τα βήματα όπως τα περιγράφουμε.
Τι πρέπει να έχεις πριν ξεκινήσεις #
Τι πρέπει να είναι έτοιμο #
- Πρόσβαση στο διαχειριστικό περιβάλλον της ιστοσελίδας (admin panel).
- Να έχεις πρόχειρο το ΑΦΜ σας.
- Πρόσβαση στο email επικοινωνίας της επιχείρησης.
- Την IP του server σου (θα τη λάβεις από την τεχνική μας ομάδα).
💡 TIP: Καλό είναι να έχεις ανοιχτές δύο καρτέλες στον browser, για να εργάζεσαι πιο εύκολα:
- Μία με το διαχειριστικό της ιστοσελίδας.
- Μία με το email της επιχείρησης.
Έτσι θα μπορείς να κάνεις εύκολα copy-paste μεταξύ των δύο. 😉
Ξεκινάμε με την Τράπεζα Πειραιώς και Epay #
Ενεργοποίηση λογαριασμού για online πληρωμές μέσω Epay #
🔑 Πριν ξεκινήσεις τη διαδικασία:
Πρέπει να επικοινωνήσεις με την Τράπεζα Πειραιώς και να ζητήσεις ενεργοποίηση λογαριασμού για online πληρωμές μέσω Epay (Redirection).
Η τράπεζα μπορεί να σε καθοδηγήσει ώστε να συμπληρώσεις τα απαραίτητα έγγραφα.
Μόλις ολοκληρώσεις αυτό το στάδιο, είναι απαραίτητο να στείλεις email στην ομάδα της Epay.
Στέλνεις email στην Epay #
🔑 Τι ζητάς:
Στέλνεις email στην Epay για να ζητήσεις δοκιμαστικά στοιχεία.
📧 Αποστολή στο: onlineservices@epayworldwide.gr
Το email πρέπει να έχει τα εξής στοιχεία:
To URL του Web site #
Είναι η βασική διεύθυνση της ιστοσελίδας σου:
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; Πάμε στο επόμενο βήμα μόλις έχεις το email με τα test στοιχεία, ξεκινάμε τις ρυθμίσεις στην ιστοσελίδα! 🚀
Παραλαβή δοκιμαστικών στοιχείων Epay #
🔑 Τι θα κάνεις εδώ:
Αφού στείλεις τα απαραίτητα στοιχεία στην Epay, η ομάδα τους θα σου απαντήσει με:
- Τα δοκιμαστικά credentials (Merchant ID, POS ID, Acquirer ID κ.λπ.).
- Ένα έγγραφο PDF που περιέχει όλες τις απαραίτητες οδηγίες και σενάρια δοκιμών.
Σε αυτό το έγγραφο θα βρεις και δοκιμαστικούς αριθμούς καρτών, καθώς και τα βήματα που πρέπει να ακολουθήσεις για να ολοκληρώσεις τις δοκιμές.
💡 Ποιος είναι ο στόχος αυτών των δοκιμών;
Ουσιαστικά, αυτό που κάνουμε είναι να διασυνδέσουμε το site με το σύστημα Epay – Redirection, ώστε:
- Οι πελάτες να μπορούν να ολοκληρώνουν αγορές με κάρτα, μέσα από το site.
- Ο κάτοχος της ιστοσελίδας να λαμβάνει τα χρήματα κατευθείαν στην Τράπεζα Πειραιώς.
📌 Μόλις περάσεις τα σενάρια, η τράπεζα σου στέλνει τα κανονικά στοιχεία για να ξεκινήσεις τις πραγματικές πληρωμές.
Δοκιμαστικά στοιχεία στο 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” για την κάθε γλώσσα ξεχωριστά. Κάν’ το όσες φορές χρειάζεται για να τις καλύψεις όλες.
- Έπειτα, προσθέτεις το αποδεκτό εικονίδιο από την τράπεζα στο Gateway Logo
- 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 είναι ΟΚ.
Βήμα 1: Φτιάξε ένα “δοκιμαστικό προϊόν” #
Πήγαινε στο admin panel του site σου, εκεί που προσθέτεις διαθεσιμότητες (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” ή κλείσετε το παράθυρο, η δοκιμή αποτυγχάνει.
🎯 Αν πέρασες όλα τα σενάρια, μπράβο σου — οι πληρωμές είναι προ των πυλών! 🥳
Ενημέρωση 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”) που δημιουργήσαμε νωρίτερα
- Κάνεις μια πραγματική κράτηση με πραγματική κάρτα (την κάρτα σου).
- Δες αν η πληρωμή ολοκληρώνεται σωστά και όλα πήγαν καλά.
🎉 Τα κατάφερες! Η ιστοσελίδα σου, δέχεται πλέον πληρωμές με κάρτα. Τελικά δεν ήταν και τόσο δύσκολο. 😄
