Οδηγός Eurobank e-Commerce για WooCommerce

Οδηγός ρύθμισης Eurobank e-Commerce για WooCommerce

Ο οδηγός αφορά το «OBS Woocommerce Cardlink Payment Gateway - EUROBANK». Αν θέλετε, η OBS Technologies κάνει όλη τη ρύθμιση δωρεάν.

Προαπαιτούμενα

• Σύμβαση e-commerce με την Eurobank / Worldline Greece και, αν θέλετε δόσεις, έγκριση δόσεων.
• Sandbox στοιχεία της Cardlink για την Eurobank: Merchant ID, Shared Secret και το test endpoint (Form Post Url). Μετά τις δοκιμές λαμβάνετε με email τους παραγωγικούς κωδικούς.
• Μάθετε αν ο λογαριασμός σας κάνει άμεση χρέωση ή προέγκριση (pre-authorization).
• WordPress με WooCommerce, ενημερωμένη PHP και SSL σε όλο το site. Κρατήστε backup αρχείων και βάσης.

Εγκατάσταση και License key

1. Κατεβάστε το ZIP και το License key από τον λογαριασμό σας στο obstechnologies.gr.
2. Πρόσθετα → Προσθήκη νέου → Μεταφόρτωση πρόσθετου, επιλέξτε το ZIP, Εγκατάσταση και μετά Ενεργοποίηση. Αν υπάρχει παλαιότερη έκδοση, αντικαταστήστε τη με το νέο ZIP, αφού κρατήσετε backup.
3. Ενεργοποιήστε το License key για το domain σας, όπως περιγράφεται στην Ενεργοποίηση άδειας.
4. Ανοίξτε WooCommerce → Ρυθμίσεις → Πληρωμές → Cardlink Payment.

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

• Enable/Disable («Enable Cardlink Payments»): ενεργοποίηση της μεθόδου. Κρατήστε τη κλειστή στο live μέχρι να έχετε παραγωγικά στοιχεία.
• Title: ο τίτλος στο checkout (προεπιλογή «Cardlink Payments»). Προτείνουμε «Πληρωμή με κάρτα».
• Description: η περιγραφή στο checkout. Η προεπιλογή («Pay instantly from your bank account») δεν περιγράφει πληρωμή με κάρτα, οπότε αλλάξτε τη, π.χ. «Πληρωμή με Visa, Mastercard ή Maestro στο ασφαλές περιβάλλον της Eurobank».
• Cardlink Form Post Url: το HTTPS endpoint της Eurobank/Cardlink, πρώτα το δοκιμαστικό και μετά το παραγωγικό. URL χωρίς https:// απορρίπτεται κατά την αποθήκευση.
• Cardlink Merchant ID: το Merchant ID του περιβάλλοντος.
• Pre-Authorize: ενεργοποιήστε το μόνο αν ο λογαριασμός σας κάνει προέγκριση. Τότε η παραγγελία μένει «Σε αναμονή» και η χρέωση ολοκληρώνεται στο merchant portal.
• Cardlink Shared Secret Key: το μυστικό κλειδί για τον υπολογισμό και τον έλεγχο του digest. Μην το στέλνετε σε email ή ticket.
• Installments: πίνακας με Min Total, Max Total, Max Installments και, προαιρετικά, Specific Installments. Κάθε γραμμή ισχύει για σύνολο μεγαλύτερο από το Min και έως το Max. Για παράδειγμα, 0–100 με δόσεις 2,3 και 100–200 με δόσεις 2,4,6. Αφήστε το κενό για πληρωμή χωρίς δόσεις.

Το URL επιβεβαίωσης και ακύρωσης που στέλνει το plugin στην τράπεζα είναι https://το-domain-σας/wc-api/WC_Gateway_Cardlink/. Πρέπει να είναι προσβάσιμο χωρίς cache, firewall/WAF, κωδικό πρόσβασης ή maintenance mode.

Δοκιμή (sandbox)

Δεν υπάρχει ξεχωριστός διακόπτης «test mode». Η δοκιμή γίνεται με το test endpoint και τα sandbox στοιχεία της Cardlink.

1. Κάντε μια μικρή παραγγελία χωρίς δόσεις με δοκιμαστική κάρτα. Η παραγγελία πρέπει να γίνει πληρωμένη μία φορά.
2. Κάντε μία παραγγελία με τον μέγιστο αριθμό δόσεων της κλίμακας.
3. Δοκιμάστε απόρριψη και ακύρωση. Ο πελάτης πρέπει να επιστρέψει στο checkout με μήνυμα και η παραγγελία να γίνει «Αποτυχημένη».
4. Αν χρησιμοποιείτε Pre-Authorize, ελέγξτε ότι η παραγγελία μένει «Σε αναμονή».
5. Επαναλάβετε σε κλασικό checkout και σε Blocks. Μετά ολοκληρώστε τα test cases στο περιβάλλον developers της Cardlink για να εκδοθούν τα live στοιχεία.

Go-live checklist

• Η Worldline σας έστειλε τους παραγωγικούς κωδικούς και έχετε αντικαταστήσει Form Post Url, Merchant ID και Shared Secret με τα live.
• Δεν έχουν μείνει τιμές από άλλη τράπεζα (π.χ. Alpha) ή από το sandbox.
• Το Pre-Authorize συμφωνεί με τη σύμβαση και οι δόσεις με όσες έχουν εγκριθεί.
• Το /wc-api/WC_Gateway_Cardlink/ έχει εξαιρεθεί από cache και firewall.
• Κάνατε μια μικρή πραγματική συναλλαγή, την επιστρέψατε από το merchant portal και η παραγγελία ενημερώθηκε σωστά.

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

• Η τράπεζα δείχνει την πληρωμή εγκεκριμένη (CAPTURED), αλλά η παραγγελία μένει «Εκκρεμεί πληρωμή» και αργότερα ακυρώνεται αυτόματα.
  Αιτία: Η απάντηση της τράπεζας δεν έφτασε ή δεν επαληθεύτηκε: cache, firewall, maintenance mode, ή digest που δεν ταιριάζει σε παλιές εκδόσεις του plugin (π.χ. σε απαντήσεις IRIS). Η αυτόματη ακύρωση γίνεται από τη ρύθμιση «Διατήρηση αποθέματος» του WooCommerce για απλήρωτες παραγγελίες.
  Λύση: Αναβαθμίστε στην τρέχουσα έκδοση του plugin, εξαιρέστε το /wc-api/WC_Gateway_Cardlink/ από cache και firewall και ελέγξτε τη συναλλαγή στο merchant portal. Αν υπάρχει πληρωμή σε ακυρωμένη παραγγελία, επαναφέρετέ τη χειροκίνητα ή κάντε επιστροφή χρημάτων.
• Ο πελάτης επιστρέφει στο checkout με μήνυμα «Παρουσιάστηκε σφάλμα κατά την επεξεργασία της πληρωμής σας μέσω Cardlink».
  Αιτία: Ο έλεγχος digest απέτυχε: Shared Secret άλλου περιβάλλοντος (sandbox ή live), λάθος Merchant ID, ή μορφή απάντησης που δεν αναγνωρίζει η εγκατεστημένη έκδοση.
  Λύση: Ελέγξτε ότι Form Post Url, Merchant ID και Shared Secret ανήκουν στο ίδιο περιβάλλον και αναβαθμίστε το plugin. Αν συνεχίζει, στείλτε στην OBS ώρα και αριθμό παραγγελίας, χωρίς κωδικούς.
• Μήνυμα «Η απάντηση της Eurobank δεν μπόρεσε να επαληθευτεί».
  Αιτία: Το ποσό, το νόμισμα, η απόπειρα πληρωμής ή το Merchant ID της απάντησης δεν ταιριάζει με την παραγγελία, π.χ. αλλαγή καλαθιού μετά την ανακατεύθυνση.
  Λύση: Μην εκτελέσετε την παραγγελία πριν τη βρείτε στο merchant portal. Ζητήστε από τον πελάτη νέα πληρωμή ή κάντε επιστροφή χρημάτων.
• Σποραδικά δεν γίνεται ανακατεύθυνση στην τράπεζα και πολλές παραγγελίες μένουν σε εκκρεμότητα.
  Αιτία: Παλιά έκδοση του plugin, cache στη σελίδα πληρωμής ή κάποιο plugin βελτιστοποίησης που μπλοκάρει την αυτόματη υποβολή της φόρμας προς την τράπεζα.
  Λύση: Αναβαθμίστε το plugin, εξαιρέστε τις σελίδες checkout και πληρωμής από cache και minify/defer JavaScript, και δοκιμάστε ξανά.
• Εμφανίζονται PHP «Deprecated: Creation of dynamic property WC_Gateway_Cardlink…» ή άλλα PHP errors.
  Αιτία: Παλιά έκδοση του plugin (π.χ. 1.6.x) σε PHP 8.2 ή νεότερη.
  Λύση: Εγκαταστήστε την τρέχουσα έκδοση από την OBS. Οι ρυθμίσεις διατηρούνται, αλλά κρατήστε πάντα backup.
• Η παραγγελία μπαίνει «Αποτυχημένη», ενώ η τράπεζα δείχνει την πληρωμή ως εγκεκριμένη (AUTHORIZED).
  Αιτία: Ο λογαριασμός κάνει προέγκριση, αλλά το Pre-Authorize στο plugin είναι κλειστό.
  Λύση: Ενεργοποιήστε το Pre-Authorize ώστε οι προεγκρίσεις να μπαίνουν «Σε αναμονή», και ολοκληρώστε τη χρέωση των παραγγελιών που επηρεάστηκαν από το merchant portal.
• Δεν εμφανίζεται η επιλογή IRIS, Apple Pay ή Google Pay στη σελίδα πληρωμής.
  Αιτία: Οι μέθοδοι αυτές εμφανίζονται στη σελίδα πληρωμής της τράπεζας μόνο όταν η Worldline τις έχει ενεργοποιήσει στον λογαριασμό σας. Δεν είναι ξεχωριστά κουμπιά στο checkout του WooCommerce.
  Λύση: Ζητήστε από την Eurobank / Worldline ενεργοποίηση στο Merchant ID σας και κάντε μια δοκιμή. Βεβαιωθείτε ότι η σελίδα πληρωμής δεν ανοίγει σε iframe.
• Μετά την εγκατάσταση η ανακατεύθυνση πηγαίνει σε σελίδα άλλης τράπεζας ή τα πεδία δεν ταιριάζουν με τα στοιχεία της Eurobank.
  Αιτία: Εγκαταστάθηκε το plugin άλλης τράπεζας ή έμειναν τιμές από προηγούμενο gateway.
  Λύση: Βεβαιωθείτε ότι το ενεργό plugin είναι το «OBS Woocommerce Cardlink Payment Gateway - EUROBANK» και ότι το endpoint είναι αυτό που σας έδωσε η Eurobank/Worldline.