Οδηγός εγκατάστασης & ρύθμισης: WooCommerce Πληρωμές με PayByBank

Plugin για WooCommerce που προσθέτει πληρωμή μέσω PayByBank, με κωδικό RF ή απευθείας μεταφορά από το e-banking του πελάτη, και αυτόματη ενημέρωση της παραγγελί

Εγκατάσταση και ρύθμιση του PayByBank για WooCommerce

Ο οδηγός αφορά την έκδοση 3.0.7. Η OBS κάνει δωρεάν την εγκατάσταση και τη ρύθμιση.

Προαπαιτούμενα από την PayByBank

Συνεργασία με την PayByBank για το e-shop σας.
API Key για το δοκιμαστικό περιβάλλον και, αργότερα, για το παραγωγικό.
Επωνυμία που θα εμφανίζεται στην κίνηση λογαριασμού του πελάτη: 4–14 χαρακτήρες, μόνο λατινικά γράμματα, αριθμοί, κενό και - ? : ( ) . , ' +.
WordPress 5.6+, WooCommerce 5.6+, PHP 7.4+ και SSL (https) στο site.

Εγκατάσταση

Κατεβάστε το ZIP από τον λογαριασμό σας στην OBS. Αν εμφανιστεί μήνυμα ότι το αρχείο δεν βρέθηκε, επικοινωνήστε με την υποστήριξη για να σας σταλεί.
WordPress → Plugins → Add New → Upload Plugin → Install Now → Activate.
Ενεργοποίηση άδειας: δείτε τον οδηγό Ενεργοποίηση άδειας.
Πηγαίνετε WooCommerce → Ρυθμίσεις → Πληρωμές → PayByBank.
Αντιγράψτε τα Integration URLs της σελίδας ρυθμίσεων και στείλτε τα στην PayByBank:
- Payment URL: https://το-site-σας/wp-json/dc-paybybank/paybybank-success/
- RF Update URL: https://το-site-σας/wp-json/dc-paybybank/paybybank-rf-update/

Χάρτης ρυθμίσεων

Πεδίο	Τι κάνει	Προεπιλογή
Enable/Disable	Ενεργοποιεί την PayByBank στο checkout.	Ανενεργό
Title	Όνομα της μεθόδου στο checkout.	PayByBank - Bank Transfer
Initial Order Status	Κατάσταση της παραγγελίας μόλις εκδοθεί ο κωδικός.	Σε αναμονή (On hold)
Order Status after Successful Payment	Κατάσταση μετά την επιβεβαίωση πληρωμής.	Paid by PayByBank
API Key	Το κλειδί που σας δίνει η PayByBank (test ή live).	—
Mode (Enable test mode)	Όταν είναι τσεκαρισμένο, το plugin δουλεύει στο δοκιμαστικό περιβάλλον. Ξετσεκάρετε για live, αφού περάσετε το live API Key.	Test mode
Company Name	Επωνυμία στην κίνηση λογαριασμού του πελάτη (4–14 λατινικοί χαρακτήρες).	—
Payment Code Life (hours)	Διάρκεια ισχύος του κωδικού RF σε ώρες.	720
Extra Fee	Προαιρετική χρέωση για τη μέθοδο. Χωρίς ΦΠΑ αν το κατάστημα υπολογίζει φόρους.	—
Description	Κείμενο κάτω από τη μέθοδο στο checkout.	Κείμενο για πληρωμή από e-banking
Instructions for "Thank you" page	Οδηγίες στη σελίδα ευχαριστίας, με `{pbb_rf_code}` και `{pbb_rf_amount}`. Κενό = καμία οδηγία.	Οδηγίες πληρωμής RF
Instructions for Customer Emails	Ίδιες οδηγίες για τα emails του πελάτη.	Οδηγίες πληρωμής RF
Send extra email when Paid	Επιπλέον email στον πελάτη όταν πληρωθεί. Ο διαχειριστής ειδοποιείται πάντα.	Ενεργό
Enable logging	Καταγραφή στο WooCommerce → Κατάσταση → Logs (πηγή «paybybank»).	Ανενεργό

Δοκιμή (test mode)

Αφήστε τσεκαρισμένο το «Enable test mode» και περάστε το test API Key.
Κάντε δοκιμαστική παραγγελία με PayByBank και επιλέξτε «RF CODE».
Ελέγξτε ότι ο κωδικός RF εμφανίζεται στη σελίδα ευχαριστίας και στο email και ότι η παραγγελία είναι «Σε αναμονή».
Ολοκληρώστε τη δοκιμαστική πληρωμή με τη διαδικασία της PayByBank και ελέγξτε ότι η παραγγελία άλλαξε κατάσταση.
Δοκιμάστε το κουμπί «Request status update» στην παραγγελία.

Go-live checklist

Live API Key και «Enable test mode» ξετσεκαρισμένο.
Η PayByBank έχει καταχωρίσει τα Integration URLs του παραγωγικού domain.
Το /wp-json/ δεν μπλοκάρεται από firewall ή plugin ασφαλείας.
Το WP-Cron / Action Scheduler τρέχει, για τον καθημερινό έλεγχο κατάστασης.
Οι οδηγίες της σελίδας ευχαριστίας και των emails είναι στα ελληνικά και σωστές.

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

Σύμπτωμα	Πιθανή αιτία	Λύση
Δεν κατεβαίνει το plugin από τον λογαριασμό («Το αρχείο δεν βρέθηκε»).	Το αρχείο του προϊόντος δεν είναι διαθέσιμο στη λήψη του λογαριασμού σας.	Επικοινωνήστε με την υποστήριξη της OBS· θα σας σταλεί το σωστό ZIP και θα διορθωθεί η λήψη.
Ο πελάτης πλήρωσε αλλά η παραγγελία μένει «Σε αναμονή».	Το webhook της PayByBank δεν έφτασε (λάθος Integration URLs, firewall στο /wp-json/) ή περιμένει τον καθημερινό έλεγχο.	Πατήστε «Request status update» στην παραγγελία, ελέγξτε τα Integration URLs στην PayByBank και ότι το /wp-json/ είναι προσβάσιμο.
Δεν αποθηκεύονται οι ρυθμίσεις.	Το Company Name δεν πληροί τον κανόνα 4–14 λατινικών χαρακτήρων.	Γράψτε την επωνυμία με λατινικούς χαρακτήρες, έως 14, χωρίς ελληνικά ή ειδικά σύμβολα.
Η παραγγελία γυρίζει σε «Αποτυχημένη» και ο πελάτης επιστρέφει στο checkout.	Η δημιουργία κωδικού RF απέτυχε (λάθος API Key, test key σε live mode ή πρόβλημα επικοινωνίας).	Ελέγξτε API Key και mode, ενεργοποιήστε το logging και δείτε τον κωδικό σφάλματος στα WooCommerce logs.
Ο κωδικός RF έληξε πριν πληρώσει ο πελάτης.	Ξεπεράστηκε το Payment Code Life.	Αυξήστε τη διάρκεια ισχύος ή ζητήστε από τον πελάτη νέα παραγγελία.
Το WooCommerce δείχνει το plugin ως μη συμβατό με HPOS.	Η δήλωση συμβατότητας αφορά τον φάκελο paybybank/. Αν εγκατασταθεί σε φάκελο με άλλο όνομα, δεν αναγνωρίζεται.	Εγκαταστήστε από το επίσημο ZIP χωρίς να μετονομάσετε τον φάκελο.

← Πίσω στους οδηγούς