Οδηγός NBG Global Payments για WooCommerce

Οδηγός ρύθμισης: Εθνική Τράπεζα — Global Payments για WooCommerce

Ο οδηγός αφορά το «GlobalPayments WooCommerce — Enhanced by OBS Technologies» (1.18.0-obs) και το gateway «Unified Payments». Δεν αφορά το ξεχωριστό NBG Mastercard Gateway. Η OBS κάνει δωρεάν όλα τα παρακάτω βήματα.

Τι χρειάζεστε πριν ξεκινήσετε

• Γραπτή επιβεβαίωση ότι ο λογαριασμός σας ανήκει στο Global Payments της Εθνικής.
• Sandbox App ID και App Key, και αργότερα Live App ID, App Key και Account Name.
• Ενεργοποιημένες μεθόδους πληρωμής και 3D Secure στον λογαριασμό σας.
• Μια σελίδα «Επικοινωνία» ή «Σχετικά» με στοιχεία εξυπηρέτησης (για το «Contact Url*»).
• PHP 8.2+ με curl, dom, openssl, json, zlib, intl, mbstring, xml, WordPress 6.0+, WooCommerce, HTTPS.
• Πλήρες backup αρχείων και βάσης.

Βήμα 1: Εγκατάσταση και άδεια

1. Κατεβάστε το ZIP από τα «Downloads» του λογαριασμού σας στο obstechnologies.gr.
2. Στο WordPress ανοίξτε «Πρόσθετα» → «Προσθήκη νέου» → «Μεταφόρτωση πρόσθετου», ανεβάστε το ZIP και πατήστε «Ενεργοποίηση». Δείτε και τον γενικό οδηγό εγκατάστασης.
3. Το plugin δεν έχει πεδίο License key. Η άδεια και το domain διαχειρίζονται από τις «Άδειες χρήσης» του λογαριασμού σας (ενεργοποίηση άδειας).
4. Ανοίξτε «WooCommerce» → «Ρυθμίσεις» → «Πληρωμές» → «Unified Payments». Μόνο ένα gateway Global Payments μπορεί να είναι ενεργό.

Βήμα 2: Χάρτης ρυθμίσεων (Unified Payments)

Βήμα 3: Δοκιμή σε sandbox

1. Με απενεργοποιημένο το «Live Mode», περάστε τα sandbox στοιχεία και πατήστε «Credentials check».
2. Ενεργοποιήστε τη μέθοδο και κάντε παραγγελία με δοκιμαστική κάρτα. Επιτυχία: «Σε επεξεργασία» με σημείωση συναλλαγής.
3. Δοκιμάστε απόρριψη, ακύρωση και 3D Secure.
4. Με «Authorize only» δοκιμάστε «Capture credit card authorization» (με Drop-in UI).
5. Κάντε ολική και μερική επιστροφή.
6. Επαναλάβετε σε κλασικό checkout και Checkout Blocks.

Go-live checklist

• Η Εθνική επιβεβαίωσε τον παραγωγικό λογαριασμό και τις ενεργές μεθόδους.
• Live App ID, App Key και Account Name περασμένα, «Live Mode» ενεργό, «Credentials check» επιτυχές.
• «Contact Url*» συμπληρωμένο, «Enable Logging» ανενεργό.
• Λίστες AVS/CVN ελεγμένες.
• Τα endpoints ?wc-api=globalpayments_hpp_… εξαιρούνται από cache και firewall.
• Μια πραγματική πληρωμή μικρής αξίας επιβεβαιώθηκε και επιστράφηκε.

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

• Σύμπτωμα: Η μέθοδος πληρωμής δεν εμφανίζεται στο checkout.
  Αιτία: Τα App ID / App Key του ενεργού περιβάλλοντος (Live ή Sandbox) είναι λάθος, λείπει το υποχρεωτικό «Contact Url*», ή η μέθοδος δεν είναι ενεργή.
  Λύση: Συμπληρώστε τα στοιχεία του σωστού περιβάλλοντος και το «Contact Url*», πατήστε «Credentials check» και τσεκάρετε «Enable Gateway».
• Σύμπτωμα: Το «Credentials check» αποτυγχάνει ή η πληρωμή βγάζει σφάλμα λογαριασμού.
  Αιτία: Λάθος App Key, στοιχεία live στο sandbox (ή αντίστροφα), λάθος Account Name ή λάθος Transaction Region.
  Λύση: Ελέγξτε ότι τα στοιχεία ανήκουν στο ίδιο περιβάλλον με το «Live Mode». Αν δεν ξέρετε το Account Name, αφήστε να επιλεγεί ο προεπιλεγμένος λογαριασμός ή ζητήστε τον από την Εθνική.
• Σύμπτωμα: Ο πελάτης βλέπει «The billing address you entered doesn't match the one on file with your card provider» και η πληρωμή αναστρέφεται.
  Αιτία: Το «Check AVS CVN» είναι ενεργό και ο κωδικός AVS/CVN της συναλλαγής ανήκει στις «AVS Reject Conditions» ή «CVN Reject Conditions». Οι προεπιλογές περιλαμβάνουν και κωδικούς «AVS not supported», που είναι συνηθισμένοι σε κάρτες εκτός ΗΠΑ.
  Λύση: Ελέγξτε τις λίστες κωδικών μαζί με την OBS και την τράπεζα και κρατήστε μόνο όσους πρέπει πραγματικά να απορρίπτονται.
• Σύμπτωμα: Με Hosted Payment Pages και «Authorize only», η παραγγελία γίνεται «Αποτυχημένη» ενώ το ποσό έχει δεσμευτεί.
  Αιτία: Στις Hosted Payment Pages η τρέχουσα έκδοση ολοκληρώνει την παραγγελία μόνο όταν η πληρωμή χρεωθεί (CAPTURED).
  Λύση: Με Hosted Payment Pages χρησιμοποιήστε «Authorize + Capture». Για προέγκριση χρησιμοποιήστε Drop-in UI. Ελέγξτε τη συναλλαγή στο portal πριν αλλάξετε την παραγγελία.
• Σύμπτωμα: Ο πελάτης πλήρωσε στη σελίδα πληρωμής, αλλά η παραγγελία μένει «Εκκρεμεί πληρωμή».
  Αιτία: Η απάντηση δεν έφτασε στα endpoints ?wc-api=globalpayments_hpp_… (cache, firewall, maintenance) ή η πληρωμή είναι ακόμα σε εκκρεμότητα στον πάροχο.
  Λύση: Εξαιρέστε τα endpoints από cache και firewall και επιβεβαιώστε την πληρωμή στο portal του παρόχου πριν εκτελέσετε την παραγγελία.
• Σύμπτωμα: Δεν μπορώ να ενεργοποιήσω δεύτερο gateway Global Payments.
  Αιτία: Το plugin επιτρέπει μόνο ένα ενεργό gateway Global Payments τη φορά.
  Λύση: Χρησιμοποιήστε μόνο το «Unified Payments». Τα υπόλοιπα gateways του πακέτου αφορούν άλλες αγορές.
• Σύμπτωμα: Το plugin δεν ενεργοποιείται ή δείχνει μήνυμα για την έκδοση PHP.
  Αιτία: Ο server έχει παλαιότερη PHP ή λείπει κάποιο απαιτούμενο extension.
  Λύση: Ζητήστε από τη φιλοξενία PHP 8.2+ με curl, dom, openssl, json, zlib, intl, mbstring και xml.
• Σύμπτωμα: Δεν εμφανίζεται η ενέργεια «Capture credit card authorization».
  Αιτία: Εμφανίζεται μόνο σε παραγγελίες με Payment Action «Authorize only» που δεν έχουν ήδη χρεωθεί.
  Λύση: Ελέγξτε το Payment Action. Με «Authorize + Capture» η χρέωση γίνεται αμέσως.

Αν το πρόβλημα παραμένει, ανοίξτε ticket στην OBS με εκδόσεις, ώρα, αριθμό παραγγελίας και μήνυμα σφάλματος. Μη στέλνετε App Key, κωδικούς ή στοιχεία καρτών.