Οδηγοί
Οδηγός Alpha Bank e-Commerce για WooCommerce
Cardlink/Nexi sandbox, MID, Shared Secret, δοκιμαστικές πληρωμές και ασφαλές go-live για Alpha Bank WooCommerce.
Η Alpha Bank e-Commerce ροή χρησιμοποιεί Cardlink με business partner Nexi. Η αρχική ρύθμιση γίνεται σε sandbox και η παραγωγική ενεργοποίηση ολοκληρώνεται με τα στοιχεία που εκδίδονται για τον συγκεκριμένο merchant.
Πριν την εγκατάσταση
- Εμπορική συμφωνία Alpha Bank και πρόσβαση στο Cardlink Developer
- SSL και production-like staging checkout
- Εγκεκριμένο OBS plugin ZIP και πλήρες backup
- Καταγραφή callback/return URLs του plugin χωρίς κοινοποίηση credentials
- Πλάνο για επιτυχημένη, αποτυχημένη και ακυρωμένη δοκιμή
Sandbox στο Cardlink Developer
- Δημιουργούμε sandbox app και επιλέγουμε Nexi για συνεργασία μέσω Alpha Bank
- Αντιγράφουμε MID και Shared Secret μόνο στα προστατευμένα πεδία του gateway
- Χρησιμοποιούμε το επίσημο test endpoint https://alphaecommerce-test.cardlink.gr/vpos/shophandlermpi
- Δεν καταγράφουμε το Shared Secret σε ticket, screenshot, log ή δημόσιο documentation
- Αποφεύγουμε iframe: η Cardlink προειδοποιεί ότι μπορεί να προκαλέσει προβλήματα σε wallets, IRIS και browser redirects
Acceptance test και παραγωγική ενεργοποίηση
- Επιτυχής πληρωμή: έλεγχος ποσού/νομίσματος/digest και μία μόνο μετάβαση της παραγγελίας σε paid status
- Αποτυχία ή ακύρωση: η παραγγελία δεν σημειώνεται ως πληρωμένη
- Επανάληψη callback/refresh: δεν δημιουργεί διπλή πληρωμή ή duplicate note
- Στο Cardlink Developer ολοκληρώνουμε το test flow και το Tests Completed
- Μέχρι να εκδοθούν live credentials το gateway μένει απενεργοποιημένο στο production
- Για live χρησιμοποιούμε αποκλειστικά MID, Shared Secret και endpoint που παραδίδονται ή επιβεβαιώνονται από την τράπεζα — όχι αντιγραφή από άλλο gateway
Troubleshooting και support bundle
- Invalid digest: field order, UTF-8, ακριβές ποσό/νόμισμα και σωστό Shared Secret περιβάλλοντος
- Paid στην τράπεζα αλλά pending στο WooCommerce: callback reachability, response digest και order matching
- Λάθος endpoint: έλεγχος των Nexi/Alpha test ή production στοιχείων
- Στο support στέλνουμε plugin/WP/Woo/PHP versions, ώρα/order ID, status/error και redacted screenshots — ποτέ credentials ή στοιχεία κάρτας
Επίσημες αναφορές: Cardlink Sandbox και Redirect Integration. Δες επίσης το WooCommerce Alpha Bank e-Commerce Plugin.
Βήματα εγκατάστασης
-
Βήμα 1
Nexi sandbox app
Δημιουργούμε Cardlink app με business partner Nexi και παίρνουμε sandbox MID/Shared Secret.
-
Βήμα 2
Gateway setup
Εγκαθιστούμε το OBS plugin, περνάμε sandbox στοιχεία και επιβεβαιώνουμε το Alpha test endpoint.
-
Βήμα 3
Callback QA
Δοκιμάζουμε success, failure, cancel και επαναλαμβανόμενο callback.
-
Βήμα 4
Tests Completed
Ολοκληρώνουμε το Cardlink test flow και ζητάμε τα production στοιχεία.
-
Βήμα 5
Go-live
Περνάμε μόνο τα live στοιχεία που εκδόθηκαν για τον merchant και κάνουμε εγκεκριμένο μικρό test.
Συχνές ερωτήσεις
Ποιον partner επιλέγω για Alpha Bank;
Nexi, όπως αναφέρει η επίσημη Cardlink sandbox τεκμηρίωση.
Ποια στοιχεία χρειάζεται το plugin;
Το sandbox app παρέχει MID και Shared Secret. Τα live στοιχεία εκδίδονται μετά την ολοκλήρωση των απαιτούμενων δοκιμών.
Γιατί δεν δημοσιεύεται το live endpoint;
Χρησιμοποιούμε το endpoint που επιβεβαιώνεται για τον συγκεκριμένο merchant, ώστε να μη μεταφερθεί παλιό ή λάθος περιβάλλον.
Υποστηρίζει HPOS;
Η συμβατότητα ελέγχεται στην έκδοση WooCommerce και στο checkout περιβάλλον του eshop πριν το go-live.