Οδηγός NBG Mastercard Gateway για WooCommerce

Αυτός ο οδηγός αφορά αποκλειστικά το OBS NBG Mastercard Gateway. Δεν αφορά τη διαφορετική υλοποίηση NBG Global Payments.

Πριν το setup

• Επιβεβαίωση από την Εθνική ότι ο merchant ανήκει στο Mastercard Gateway και όχι στο Global Payments environment
• Merchant ID και API Password από το NBG Merchant Portal
• Webhook secret και προσβάσιμο HTTPS endpoint
• Πλήρες backup και ασφαλές δοκιμαστικό περιβάλλον
• Απόφαση για Purchase ή Authorize και για Hosted Checkout ή Hosted Session

Τα στοιχεία Merchant ID και API Password αντλούνται από το NBG Merchant Portal. Δεν χρησιμοποιούμε εδώ App ID/App Key του ξεχωριστού NBG Global Payments plugin.

Βασικές ρυθμίσεις

• Gateway: Custom URL
• Custom Gateway Host: ibanke-commerce.nbg.gr — μόνο το hostname, χωρίς https:// και χωρίς path
• Transaction Mode: Purchase για άμεση χρέωση ή Authorize για μεταγενέστερο capture
• Integration Model: Hosted Checkout ή Hosted Session
• Checkout interaction: redirect/lightbox ή embedded όπου υποστηρίζεται
• 3D Secure, saved tokenized cards, order prefix και webhook secret
• Προαιρετικά line items, handling fee και installments μέσω του συμβατού OBS Installments Fee plugin

Πλήρης εικόνα των ρυθμίσεων

Οι παρακάτω εικόνες καλύπτουν όλες τις ενότητες του plugin. Τα conditional πεδία εμφανίζονται ανάλογα με τις επιλογές του gateway και τα credentials παραμένουν κρυφά.

Sandbox και go-live

• Για δοκιμές ενεργοποιούμε Test Sandbox και περνάμε τα αντίστοιχα test Merchant ID/API Password
• Για production απενεργοποιούμε Test Sandbox και περνάμε στα πεδία Merchant ID/API Password τα live στοιχεία από το NBG Merchant Portal
• Το Order ID Prefix είναι προαιρετικό και χρησιμοποιείται για να ξεχωρίζουν οι παραγγελίες όταν το ίδιο Merchant ID εξυπηρετεί περισσότερες εγκαταστάσεις
• Δοκιμάζουμε success, decline, cancel και browser close
• Ελέγχουμε webhook authentication, order reference και idempotent status update
• Για Authorize δοκιμάζουμε capture και void από το WooCommerce order
• Μόνο μετά την provider έγκριση ενεργοποιούμε την production ροή

Σημαντικό: στο production setup της Εθνικής δεν επιλέγουμε Europe. Επιλέγουμε Custom URL και στο Custom Gateway Host γράφουμε ακριβώς ibanke-commerce.nbg.gr.

Troubleshooting και support

• Authentication error: λάθος Merchant ID/API Password ή λάθος gateway environment
• Hosted page δεν ανοίγει: έλεγχος integration model, gateway host, ποσού/νομίσματος και SSL
• Paid provider/pending WooCommerce: webhook, order key/reference και reconciliation
• Capture/void δεν εμφανίζεται: το order πρέπει να έχει τη σωστή payment method και status/meta
• Στο support στέλνουμε redacted settings, versions, order ID/time και response code — ποτέ credentials ή card data

Επίσημη τεχνική αναφορά: NBG Pay Gateway Developer Portal. Δες επίσης το WooCommerce NBG Mastercard Gateway Plugin.