Εγκατάσταση gatewayΣύνδεση του plugin στο WooCommerce checkout.
Στοιχεία σύνδεσης με την τράπεζαΠερνάμε τους κωδικούς εμπόρου και τις διευθύνσεις επιστροφής που ζητά η τράπεζα.
Test transactionΔοκιμή επιτυχημένης και αποτυχημένης πληρωμής πριν το live.
Υποστήριξη OBSΒοήθεια για αλλαγές provider, updates και έλεγχο checkout.
Τι κάνει πρακτικά
Δυνατότητες, μέσα στο WooCommerce
Τοπικό payment gateway
Σύνδεση WooCommerce με ελληνικό τραπεζικό ή payment-provider περιβάλλον.
Καθαρό checkout flow
Ο πελάτης ολοκληρώνει την πληρωμή στον provider και η παραγγελία ενημερώνεται στο WooCommerce.
Setup από OBS
Η ομάδα OBS ελέγχει τα στοιχεία σύνδεσης με την τράπεζα και κάνει δοκιμαστικές συναλλαγές πριν ενεργοποιηθούν οι πραγματικές πληρωμές.
Εικόνες λειτουργίας
Η πραγματική ροή μέσα στο WooCommerce
Η σελίδα ρυθμίσεων του Nexi XPay στο WooCommerce.
Ενεργοποίηση, τίτλος και περιγραφή στο checkout, Test Mode και API Key (καλυμμένο).
Δόσεις και κανόνες επιβάρυνσης ανά δόση. Οι τιμές είναι παραδείγματα.
Οι επιλογές Enable IRIS και IRIS as default. Η διαθεσιμότητα εξαρτάται από το τερματικό που έχει εγκρίνει η τράπεζα.
Πώς δουλεύει η διαδικασία
Από την παραγγελία στο αποτέλεσμα
1
Nexi terminal και API Key
Η Alpha Bank / Nexi ενεργοποιεί το terminal (κάρτες, δόσεις, IRIS) και σας δίνει API Key για sandbox και live.
2
Εγκατάσταση σε Test Mode
Η OBS εγκαθιστά το plugin, περνά το sandbox API Key και ρυθμίζει δόσεις, κανόνες τιμολόγησης και IRIS.
3
Δοκιμές και έλεγχος Nexi
Επιτυχία, απόρριψη, ακύρωση, refund και, αν χρειάζεται, capture/void. Η Nexi ελέγχει το site πριν το live.
4
Go-live
Παραγωγικό API Key, απενεργοποίηση Test Mode και μια μικρή πραγματική συναλλαγή για επιβεβαίωση.
Όταν κάτι δεν δουλεύει
Όταν η ροή δεν ολοκληρώνεται
Τα στοιχεία της τράπεζας είναι Merchant ID, Shared Secret και Form Post Url, ενώ το plugin ζητά API Key.
Αιτία: Η σύμβασή σας είναι στην παλαιότερη ροή Alpha Bank e-Commerce μέσω Cardlink και όχι στη Nexi XPay. Λύση: Χρησιμοποιήστε το WooCommerce Alpha Bank e-Commerce Plugin, ή ζητήστε από την τράπεζα ενεργοποίηση Nexi XPay και API Key.
Η τράπεζα ενημέρωσε για μετάβαση σε Nexi XPay και το eshop τρέχει ακόμη το παλιό Alpha/Cardlink gateway.
Αιτία: Αλλάζει ο επεξεργαστής. Τα παλιά στοιχεία δεν ισχύουν στο νέο περιβάλλον και δεν υπάρχει μεταφορά μισοτελειωμένων πληρωμών. Λύση: Εγκαταστήστε το Nexi XPay plugin με το νέο API Key. Οι κλίμακες δόσεων του παλιού gateway μεταφέρονται αυτόματα όπου αναγνωρίζονται, αλλιώς ρυθμίζονται χειροκίνητα. Όσες πληρωμές είχαν ξεκινήσει στο παλιό gateway, ο πελάτης τις ξαναξεκινά.
Η Nexi δεν εγκρίνει το site για live και ζητά αλλαγές.
Αιτία: Ο έλεγχος της Nexi απαιτεί σαφή αναφορά στο Nexi XPay ως τρόπο πληρωμής, λογότυπα των αποδεκτών καρτών και ενημερωμένους όρους πληρωμής και ασφάλειας. Λύση: Αλλάξτε το Title/Description ώστε να αναφέρει το Nexi XPay και αφαιρέστε παλιές αναφορές σε άλλο σύστημα πληρωμών. Από την 2.1.3 το checkout δείχνει το επίσημο banner καρτών Nexi. Ενημερώστε και τη σελίδα όρων.
Δοκιμαστικές ή πραγματικές συναλλαγές απορρίπτονται με «Transaction Declined».
Αιτία: Στο sandbox συνήθως χρησιμοποιείται κάρτα που δεν είναι από τις δοκιμαστικές της Nexi. Στο live η απόρριψη έρχεται συνήθως από τον εκδότη της κάρτας (π.χ. αποτυχία 3D Secure) και όχι από το plugin. Λύση: Στο sandbox χρησιμοποιήστε τις δοκιμαστικές κάρτες της Nexi. Στο live ελέγξτε τον λόγο απόρριψης στο Nexi portal και ζητήστε από τον πελάτη να επικοινωνήσει με την τράπεζά του ή να δοκιμάσει άλλη κάρτα.
Απορρίψεις όταν ο πελάτης γράφει το όνομα κατόχου με τελείες ή σύμβολα.
Αιτία: Το πεδίο ονόματος κατόχου συμπληρώνεται στη σελίδα πληρωμής της Nexi και ορισμένα σύμβολα μπορεί να οδηγήσουν σε απόρριψη. Λύση: Ζητήστε από τον πελάτη να γράψει το όνομα όπως είναι τυπωμένο στην κάρτα, χωρίς τελείες ή σύμβολα, και να ξαναδοκιμάσει.
Ο πελάτης πλήρωσε, αλλά η παραγγελία μένει «Σε αναμονή πληρωμής».
Αιτία: Η ειδοποίηση της Nexi δεν έφτασε στο REST route του plugin (απενεργοποιημένο REST API, firewall/WAF, maintenance mode, προστασία με κωδικό) ή η Nexi δεν έχει ακόμη τελική κατάσταση. Λύση: Βεβαιωθείτε ότι το /wp-json/obs-nexi-xpay/v1/ είναι προσβάσιμο από το internet και ότι λειτουργούν τα loopback requests και το WP-Cron. Ελέγξτε τη συναλλαγή στο Nexi portal πριν εκτελέσετε την παραγγελία.
Η παραγγελία μπήκε «Σε αναμονή» με σημείωση «amount/currency mismatch».
Αιτία: Το ποσό ή το νόμισμα της Nexi δεν ταιριάζει με την παραγγελία, π.χ. αλλαγή συνόλου μετά την ανακατεύθυνση. Λύση: Μην εκτελέσετε την παραγγελία. Συγκρίνετε με το Nexi portal και κάντε επιστροφή ή ζητήστε νέα πληρωμή.
Δεν εμφανίζονται οι ενέργειες Capture/Void στην παραγγελία.
Αιτία: Το terminal κάνει άμεση (implicit) χρέωση ή η παραγγελία δεν έχει αναφορά Nexi. Λύση: Σε implicit terminal δεν χρειάζεται capture και η επιστροφή γίνεται με refund. Για explicit χρέωση ζητήστε από τη Nexi το αντίστοιχο terminal και API Key.
Δεν εμφανίζονται δόσεις στο checkout.
Αιτία: Το Enable installments είναι κλειστό, το Maximum installments είναι 1, το σύνολο δεν καλύπτει κανένα όριο ή το JSON των ορίων δεν είναι έγκυρο. Λύση: Ελέγξτε τις τρεις ρυθμίσεις και τη μορφή του JSON. Αν το terminal δεν έχει δόσεις, η Nexi θα απορρίψει την πληρωμή με δόσεις.
Το IRIS δεν εμφανίζεται ή η πληρωμή IRIS αποτυγχάνει.
Αιτία: Το IRIS δεν είναι ενεργό στο Nexi terminal ή δεν έχει ενεργοποιηθεί το Enable IRIS. Στο sandbox η ροή QR της Nexi μπορεί να αποτυγχάνει. Λύση: Ζητήστε από την τράπεζα / Nexi ενεργοποίηση IRIS στο terminal, ενεργοποιήστε το Enable IRIS και δοκιμάστε με μικρό ποσό στο live.
Περιγραφή
Αναλυτική περιγραφή
Το plugin ενσωματώνει την Alpha Bank X Pay στο eshop σας, με υποστήριξη καρτών Visa, Mastercard, Maestro, American Express και Diners Club και συμβατότητα με τις τελευταίες αναβαθμίσεις της τράπεζας. Το ψηφιακό πορτοφόλι Masterpass εμφανίζεται ως ξεχωριστή επιλογή στο checkout, ενώ υποστηρίζονται δόσεις κατόπιν έγκρισης από την Alpha Bank, με δωρεάν εγκατάσταση από την OBS.
Το Nexi XPay WooCommerce plugin της OBS Technologies συνδέει το κατάστημά σας με τη Nexi XPay, την πλατφόρμα ηλεκτρονικών πληρωμών της Nexi Greece που χρησιμοποιεί η Alpha Bank για τους εμπόρους της. Ο πελάτης πληρώνει με κάρτα, σε δόσεις ή με IRIS στη σελίδα πληρωμής της Nexi (Hosted Payment Page), και η παραγγελία ενημερώνεται αυτόματα στο WooCommerce.
Είναι ιδανικό για ελληνικά eshop που υπέγραψαν πρόσφατα με την Alpha Bank ή που η τράπεζα τα ενημέρωσε για μετάβαση στο νέο περιβάλλον Nexi XPay. Χτίστηκε εξαρχής από την OBS πάνω στο επίσημο Nexi Greece Payment API.
Προσοχή, Nexi XPay ή Cardlink; Αν η τράπεζα σας έδωσε ένα API Key από το Nexi merchant portal, χρειάζεστε αυτό το plugin. Αν σας έδωσε Merchant ID, Shared Secret και Form Post Url (παλαιότερη ροή Alpha Bank e-Commerce μέσω Cardlink), χρειάζεστε το WooCommerce Alpha Bank e-Commerce Plugin. Αν δεν είστε σίγουροι, στείλτε μας τι παραλάβατε, χωρίς κωδικούς, και σας λέμε ποιο ταιριάζει.
Πώς ξεκινάτε με τη Nexi XPay
Σύμβαση e-commerce με την Alpha Bank / Nexi. Ζητήστε αποδοχή καρτών και, αν τις θέλετε, δόσεις και IRIS στο terminal σας.
Δοκιμαστικό API Key. Από το Nexi merchant portal παίρνετε το API Key για το sandbox και μαθαίνετε αν το terminal σας κάνει άμεση χρέωση (implicit) ή προέγκριση με μεταγενέστερη χρέωση (explicit).
Εγκατάσταση και δοκιμές. Η OBS εγκαθιστά το plugin σε Test Mode, ρυθμίζει δόσεις και IRIS και δοκιμάζει επιτυχία, απόρριψη, ακύρωση και επιστροφή χρημάτων.
Έλεγχος από τη Nexi και go-live. Η Nexi ελέγχει το site (τρόπος πληρωμής, λογότυπα καρτών, όροι). Μετά περνάμε το παραγωγικό API Key και κλείνουμε το Test Mode.
Τεχνικά χαρακτηριστικά
Ανακατεύθυνση στη Hosted Payment Page της Nexi, όπου γίνονται η εισαγωγή κάρτας και ο έλεγχος 3D Secure. Η σελίδα ανοίγει στα ελληνικά ή στα αγγλικά, ανάλογα με τη γλώσσα του site.
Ελληνικές δόσεις (πρόγραμμα ACQUIRER_AGREEMENT): μέγιστος αριθμός δόσεων, προαιρετικά όρια ανά ποσό παραγγελίας και επιλογή δόσεων στο κλασικό checkout και στα Blocks, με το ποσό ανά δόση. Το πραγματικό όριο το ορίζει η σύμβαση με τον acquirer.
Κανόνες τιμολόγησης δόσεων OBS: έκπτωση για εφάπαξ πληρωμή, επιβάρυνση ανά αριθμό δόσεων σε απλό πίνακα, εξαιρούμενες κατηγορίες και σωστός υπολογισμός ανά κλάση ΦΠΑ. Κάθε προσαρμογή καταγράφεται σε σημείωση της παραγγελίας. Το ποσοστό της επιβάρυνσης δεν εμφανίζεται στον πελάτη, μόνο το ποσό.
Εκτίμηση δόσεων στη σελίδα προϊόντος (προαιρετική): dropdown με τιμή μετρητοίς, ποσό ανά δόση και σύνολο. Λειτουργεί και σε μεταβλητά προϊόντα.
IRIS (πληρωμή από λογαριασμό σε λογαριασμό μέσω ΔΙΑΣ): ενεργοποιείται από τις ρυθμίσεις και μπορεί να προεπιλεγεί στη σελίδα πληρωμής, εφόσον είναι ενεργό στο Nexi terminal σας.
Ασφαλής επιβεβαίωση πληρωμής: server-to-server ειδοποίηση με μοναδικό token ανά παραγγελία. Η τελική κατάσταση διαβάζεται πάντα από τη Nexi και ελέγχονται ποσό και νόμισμα. Αν δεν ταιριάζουν, η παραγγελία μπαίνει «Σε αναμονή» για έλεγχο. Ο μηχανισμός κλειδώματος αποτρέπει διπλή ολοκλήρωση.
Καταστάσεις παραγγελίας: επιτυχία → «Σε επεξεργασία» (με τα standard emails του WooCommerce), αποτυχία → «Αποτυχημένη», ακύρωση από τον πελάτη → «Ακυρωμένη».
Refunds από το WooCommerce (ολικά ή μερικά), και σε terminal με explicit χρέωση ενέργειες Capture και Void στην παραγγελία.
HPOS και Cart & Checkout Blocks, ελληνική μετάφραση και logs χωρίς κωδικούς ή στοιχεία καρτών.
Αναβάθμιση από παλαιότερη εγκατάσταση: οι ρυθμίσεις διατηρούνται και οι κλίμακες δόσεων του παλιού Alpha/Cardlink gateway μεταφέρονται αυτόματα όπου αναγνωρίζονται.
Στιγμιότυπα
Η σελίδα ρυθμίσεων Nexi XPay στο WooCommerce.Γενικές ρυθμίσεις: ενεργοποίηση, τίτλος, API Key, Test Mode.Ελληνικές δόσεις, έκπτωση εφάπαξ πληρωμής και επιβάρυνση ανά δόση.IRIS μέσα από το Nexi XPay: Enable IRIS και IRIS as default.
Γιατί να επιλέξετε την OBS Technologies
ΔΩΡΕΑΝ εγκατάσταση & παραμετροποίηση, μαζί με τις δοκιμές στο sandbox της Nexi.
Συχνές ενημερώσεις για συμβατότητα με WordPress, WooCommerce και τις αλλαγές της Nexi.
Άμεση υποστήριξη στα ελληνικά, με τηλέφωνο και email.
Λύσεις εφ' όρου ζωής, χωρίς ετήσια συνδρομή.
Το πακέτο περιέχει
Συμπιεσμένο αρχείο του πρόσθετου
1 License key για ένα ηλεκτρονικό κατάστημα
ΔΩΡΕΑΝ: οδηγίες, εγκατάσταση & υποστήριξη από την OBS Technologies
Απαιτεί WordPress 5.8+, WooCommerce 6.0+ (δοκιμασμένο έως 10.6) και PHP 7.4+, και είναι συμβατό με HPOS και Checkout Blocks. Η τιμή είναι 50€ με ΦΠΑ, εφάπαξ. Οι χρεώσεις της τράπεζας/Nexi είναι ξεχωριστές. Δείτε τον οδηγό ρύθμισης Nexi XPay. Αν συνεργάζεστε και με άλλη τράπεζα, δείτε το Eurobank e-Commerce plugin ή το Piraeus Bank e-Commerce plugin. Επικοινωνήστε μαζί μας για να ελέγξουμε μαζί σας τις δυνατότητες του Nexi terminal σας πριν την αγορά.
Για προγραμματιστές
obs_single_installment_discount — filter για το ποσοστό έκπτωσης εφάπαξ πληρωμής (συμβατό με τις παλιές OBS προσαρμογές).
obs_exclude_installment_categories — filter για τις κατηγορίες που εξαιρούνται από έκπτωση και επιβάρυνση. Δέχεται και product ID.
obs_nexi_xpay_lock_timeout / obs_nexi_xpay_lock_attempts — filters για το timeout (προεπιλογή 60) και τις προσπάθειες (προεπιλογή 30) του κλειδώματος ολοκλήρωσης.
2.0.0: νέα ασφαλής ροή ειδοποιήσεων, ελληνικές δόσεις, IRIS, refunds/capture/void, HPOS και Blocks.
Συχνές ερωτήσεις
Απαντήσεις πριν την αγορά
Αν η τράπεζα σας έδωσε API Key από το Nexi merchant portal, χρειάζεστε αυτό το plugin (Nexi XPay). Αν σας έδωσε Merchant ID, Shared Secret και Form Post Url, πρόκειται για τη ροή Cardlink και χρειάζεστε το WooCommerce Alpha Bank e-Commerce Plugin. Στείλτε μας τι παραλάβατε, χωρίς κωδικούς, για να σας κατευθύνουμε.
Χρειάζεστε το Nexi XPay plugin και νέο API Key από τη Nexi. Η OBS το εγκαθιστά, μεταφέρει όπου γίνεται τις κλίμακες δόσεων του παλιού gateway και κάνει τις δοκιμές. Οι ολοκληρωμένες παραγγελίες δεν επηρεάζονται.
Ναι, το IRIS περιλαμβάνεται και δεν χρειάζεστε άλλο plugin. Ενεργοποιείται με το Enable IRIS και μπορεί να προεπιλεγεί στη σελίδα πληρωμής με το IRIS as default. Πρέπει όμως πρώτα η τράπεζα / Nexi να το έχει ενεργοποιήσει στο terminal σας.
Όσες προβλέπει η σύμβαση του terminal σας με τον acquirer (πρόγραμμα ACQUIRER_AGREEMENT). Το plugin σας αφήνει να ορίσετε μέγιστο και όρια ανά ποσό παραγγελίας, αλλά το πραγματικό όριο το ορίζει η τράπεζα.
Ναι. Ορίζετε έκπτωση εφάπαξ πληρωμής, ποσοστό επιβάρυνσης ανά αριθμό δόσεων και κατηγορίες που εξαιρούνται. Ο πελάτης βλέπει το ποσό και όχι το ποσοστό, και κάθε προσαρμογή καταγράφεται στην παραγγελία. Βεβαιωθείτε ότι η επιβάρυνση επιτρέπεται από τη σύμβασή σας.
Πριν το live η Nexi ελέγχει το site. Συνήθως ζητά ο τρόπος πληρωμής να αναφέρει ρητά το Nexi XPay, να εμφανίζονται τα λογότυπα των αποδεκτών καρτών και να είναι ενημερωμένοι οι όροι πληρωμής. Η OBS σας βοηθά να κάνετε αυτές τις αλλαγές.
Στο sandbox πρέπει να χρησιμοποιείτε τις δοκιμαστικές κάρτες της Nexi. Στο live οι απορρίψεις συνήθως έρχονται από τον εκδότη της κάρτας (π.χ. αποτυχία 3D Secure) ή από σύμβολα στο όνομα κατόχου. Ο ακριβής λόγος φαίνεται στο Nexi portal.
Ναι. Οι επιστροφές, ολικές ή μερικές, γίνονται από την παραγγελία στο WooCommerce. Αν το terminal σας κάνει προέγκριση (explicit), η παραγγελία έχει επίσης τις ενέργειες Capture και Void.
Στο implicit terminal η κάρτα χρεώνεται αμέσως με την πληρωμή. Στο explicit terminal γίνεται πρώτα προέγκριση και η χρέωση ολοκληρώνεται αργότερα με Capture (ή ακυρώνεται με Void). Το είδος του terminal το ορίζει η Nexi.
Συνήθως η ειδοποίηση της Nexi δεν μπορεί να φτάσει στο REST API του site λόγω firewall, maintenance mode ή απενεργοποιημένου REST API. Ελέγξτε την πρόσβαση στο /wp-json/obs-nexi-xpay/v1/ και τη συναλλαγή στο Nexi portal πριν εκτελέσετε την παραγγελία.
Ναι. Δηλώνει συμβατότητα με HPOS και Cart & Checkout Blocks, και οι δόσεις, με το ποσό ανά δόση, λειτουργούν και στα Blocks. Απαιτεί WordPress 5.8+, WooCommerce 6.0+ και PHP 7.4+.
50€ με ΦΠΑ, εφάπαξ, χωρίς συνδρομή. Περιλαμβάνει το plugin, 1 License key για ένα eshop και δωρεάν εγκατάσταση, ρύθμιση και υποστήριξη από την OBS. Οι προμήθειες της τράπεζας/Nexi είναι ξεχωριστές.
Αμέσως μετά την πληρωμή κατεβάζετε το plugin και το license key από τον λογαριασμό σας και λαμβάνετε παραστατικό με ΦΠΑ 24%. Η δωρεάν εγκατάσταση από την ομάδα OBS προγραμματίζεται σε συνεννόηση μαζί σας μέσα σε λίγες εργάσιμες ημέρες.
Η OBS. Η εγκατάσταση και η αρχική παραμετροποίηση στο eshop σας περιλαμβάνονται δωρεάν στην αγορά, μαζί με έλεγχο λειτουργίας πριν το live.
Η άδεια ισχύει για ένα production domain και μπορείτε να τη μεταφέρετε σε νέο domain μέσα από τον λογαριασμό σας. Για πολλά eshop ή agencies υπάρχουν πακέτα πολλαπλών ενεργοποιήσεων — ρωτήστε μας.
Όχι. Πληρώνετε μία φορά — η άδεια είναι εφ' όρου ζωής και οι ενημερώσεις συμβατότητας με νέες εκδόσεις WooCommerce/WordPress και η ελληνική τεχνική υποστήριξη περιλαμβάνονται χωρίς συνδρομή ή κρυφές χρεώσεις.
Πιστεύετε ότι λείπει κάτι;
Κάνουμε τις απαιτήσεις σας στόχους μας. Ζητήστε μια λειτουργία και την αξιολογούμε για τις επόμενες εκδόσεις του προσθέτου.
Από το 2005, η OBS Technologies χτίζει και συντηρεί ελληνικές integrations για WooCommerce & WordPress — με δωρεάν setup σε κάθε αγορά και υποστήριξη από την Αθήνα.
Άμεση εξυπηρέτηση
Τηλεφωνική και email υποστήριξη από την ομάδα μας.
Ασφαλές λογισμικό
Ελεγμένα και ασφαλή προϊόντα για την ιστοσελίδα σας.
Συχνές ενημερώσεις
Αποδοτικά, συμβατά και καινοτόμα πρόσθετα.
Στις απαιτήσεις σας
Κάνουμε τις απαιτήσεις σας στόχους και τις υλοποιούμε.
Πληρωμές & Δόσεις
Ξεκινήστε με WooCommerce Alpha Bank X Pay e-Commerce Plugin
Αγοράστε σήμερα — η ομάδα της OBS εγκαθιστά και ρυθμίζει το plugin στο eshop σας. Καμία τεχνική ενέργεια από εσάς.