Πώς λειτουργούν οι πληρωμές Winbank ePay σε OpenCart και γιατί εμφανίζονται missing orders

Τι είναι το redirect payment flow

Στο redirect payment flow, το OpenCart δεν χρεώνει την κάρτα μέσα στο κατάστημα. Το payment extension προετοιμάζει την προσπάθεια πληρωμής και στη συνέχεια μεταφέρει τον πελάτη στο ασφαλές περιβάλλον της Πειραιώς / Winbank ePay.

Το κατάστημα δεν βλέπει στοιχεία κάρτας και δεν ελέγχει το τελικό payment UI της τράπεζας. Η τράπεζα εμφανίζει στον πελάτη το ποσό, τις διαθέσιμες επιλογές πληρωμής και τη διαδικασία επιβεβαίωσης, σύμφωνα με τη σύμβαση του εμπόρου.

Βήμα προς βήμα ροή πληρωμής

Η βασική ροή έχει συγκεκριμένα στάδια. Το κρίσιμο σημείο είναι ότι το OpenCart μαθαίνει το αποτέλεσμα μόνο όταν η τράπεζα επιστρέψει σωστά τα δεδομένα επιβεβαίωσης.

1. 01

   Ο πελάτης βρίσκεται στο checkout

   Ο πελάτης έχει προϊόντα στο καλάθι και βρίσκεται στο checkout του OpenCart.

2. 02

   Επιλέγει πληρωμή με κάρτα μέσω Winbank ePay

   Η επιλογή πληρωμής ενεργοποιεί το payment extension που συνδέει το OpenCart με το ePay περιβάλλον.

3. 03

   Το extension ζητά payment ticket

   Το extension επικοινωνεί με το ePay σύστημα της Πειραιώς και ζητά ένα ticket για το ποσό της συγκεκριμένης παραγγελίας.

4. 04

   Η Πειραιώς επιστρέφει reference

   Το ePay επιστρέφει ticket ή reference για τη συγκεκριμένη προσπάθεια πληρωμής.

5. 05

   Το OpenCart κάνει redirect

   Όταν ο πελάτης ολοκληρώσει την παραγγελία, το OpenCart τον μεταφέρει στο ασφαλές περιβάλλον της τράπεζας μαζί με το ticket.

6. 06

   Ο πελάτης είναι πλέον εκτός καταστήματος

   Από αυτό το σημείο το OpenCart δεν γνωρίζει αν ο πελάτης θα πληρώσει, θα ακυρώσει, θα αποτύχει, θα κλείσει το παράθυρο ή θα εγκαταλείψει τη διαδικασία.

7. 07

   Η τράπεζα εμφανίζει το αποτέλεσμα

   Αν η πληρωμή ολοκληρωθεί ή ακυρωθεί, το αποτέλεσμα εμφανίζεται στο περιβάλλον της Πειραιώς / Winbank ePay.

8. 08

   Η Πειραιώς επιστρέφει στο success URL

   Για να ενημερωθεί η παραγγελία, το ePay πρέπει να επιστρέψει τον πελάτη στο σωστό success URL και να στείλει τα απαραίτητα POST δεδομένα.

9. 09

   Το extension ελέγχει την απάντηση

   Το extension διαβάζει τα POST δεδομένα, ελέγχει αν είναι έγκυρα και αποφασίζει αν πρέπει να ενημερώσει το order status.

10. 10

    Η παραγγελία ενημερώνεται ή μένει ανοιχτή

    Αν η απάντηση είναι έγκυρη και επιτυχημένη, η παραγγελία ενημερώνεται. Αν δεν υπάρχει έγκυρη επιστροφή, το OpenCart δεν πρέπει να θεωρήσει αυτόματα ότι πληρώθηκε.

Γιατί εμφανίζονται missing orders στο OpenCart

Το OpenCart μπορεί να δημιουργήσει ή να κρατήσει προσωρινά την παραγγελία πριν επιβεβαιωθεί η πληρωμή. Αυτό επιτρέπει στο checkout να έχει order reference όσο ο πελάτης μεταφέρεται στην τράπεζα.

Αν ο πελάτης φύγει προς το ePay αλλά δεν επιστρέψει σωστά στο κατάστημα, το OpenCart δεν λαμβάνει την τελική επιβεβαίωση και δεν μπορεί να αλλάξει αξιόπιστα την κατάσταση της παραγγελίας.

• Η παραγγελία μπορεί να υπάρχει στη βάση δεδομένων.
• Δεν σημαίνει απαραίτητα ότι πληρώθηκε.
• Δεν σημαίνει απαραίτητα ότι η πληρωμή απέτυχε.
• Σημαίνει ότι το κατάστημα δεν έλαβε την τελική έγκυρη επιβεβαίωση.
• Ο διαχειριστής πρέπει να ελέγξει το ePay περιβάλλον ή το email επιβεβαίωσης της τράπεζας.

Γιατί το κατάστημα δεν γνωρίζει πάντα το αποτέλεσμα της πληρωμής

Μετά το redirect, ο πελάτης βρίσκεται στο περιβάλλον της τράπεζας. Το OpenCart δεν εκτελεί πλέον τη διαδικασία πληρωμής και δεν έχει πρόσβαση στο τι κάνει ο πελάτης εκεί.

Αν δεν γίνει σωστά η επιστροφή στο success URL, το κατάστημα δεν λαμβάνει το POST request με το αποτέλεσμα. Σε αυτή την περίπτωση δεν μπορεί να γνωρίζει αυτόματα αν η πληρωμή ολοκληρώθηκε, ακυρώθηκε ή εγκαταλείφθηκε.

Τι είναι το success URL και γιατί είναι σημαντικό

Το success URL είναι η διεύθυνση του OpenCart στην οποία επιστρέφει η Πειραιώς μετά τη διαδικασία πληρωμής. Εκεί το ePay στέλνει τα response δεδομένα που χρειάζεται το extension για να ελέγξει το αποτέλεσμα.

Αν το URL είναι λάθος ή αν κάποιο τεχνικό layer αλλάζει το request, το OpenCart μπορεί να μη λάβει σωστά την επιβεβαίωση ακόμη και όταν ο πελάτης ολοκλήρωσε τη διαδικασία στην τράπεζα.

• Το success URL πρέπει να είναι το σωστό live URL του καταστήματος.
• Πρέπει να δέχεται POST requests χωρίς να χάνονται δεδομένα.
• Πρέπει να έχει έγκυρο SSL certificate.
• Δεν πρέπει να γίνεται cache το payment callback ή success route.
• Redirects από HTTP σε HTTPS, non-www σε www ή άλλο canonical path μπορεί να χαλάσουν την επιστροφή αν χάσουν POST data.

Demo και live περιβάλλον

Η Πειραιώς συνήθως ζητά δοκιμαστικές πληρωμές στο demo περιβάλλον για να επιβεβαιωθεί ότι η ροή λειτουργεί σωστά. Όταν δοθούν τα live στοιχεία, η τεχνική ροή παραμένει ίδια, αλλά τα live URLs πρέπει να είναι σωστά δηλωμένα.

Προβλήματα εμφανίζονται συχνά όταν η μετάβαση από demo σε live αλλάζει domain, credentials ή routing χωρίς να ενημερωθεί αντίστοιχα το ePay περιβάλλον.

• Τα demo URLs μπορεί να έχουν μείνει δηλωμένα στο live περιβάλλον.
• Το live domain μπορεί να διαφέρει από το demo domain.
• Το κατάστημα μπορεί να έχει αλλάξει domain ή checkout route.
• Νέο firewall, cache, CDN ή redirect rule μπορεί να μπλοκάρει την επιστροφή.
• Το success URL μπορεί να μη δέχεται σωστά POST requests.

Μπορεί να γίνει διπλή πληρωμή;

Σε φυσιολογική ροή, μία προσπάθεια πληρωμής αντιστοιχεί σε ένα συγκεκριμένο ticket ή reference και σε ένα συγκεκριμένο ποσό που εμφανίζεται στο περιβάλλον της Πειραιώς.

Το extension δεν χρεώνει κάρτες απευθείας. Η τελική χρέωση γίνεται στο περιβάλλον της τράπεζας, αφού ο πελάτης δει και επιβεβαιώσει το ποσό.

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

• Για κάθε προσπάθεια, ο πελάτης βλέπει το ποσό στην Πειραιώς πριν επιβεβαιώσει.
• Το OpenCart δεν μπορεί να χρεώσει κάρτα χωρίς ολοκλήρωση της διαδικασίας στο ePay.
• Αν υπάρχει αμφιβολία, ο διαχειριστής ελέγχει το ePay admin ή το email επιβεβαίωσης της τράπεζας.

Τι να ελέγξετε όταν η παραγγελία δεν ενημερώνεται

Όταν υπάρχει πληρωμή στην τράπεζα αλλά η παραγγελία δεν φαίνεται ολοκληρωμένη στο OpenCart, ο έλεγχος πρέπει να γίνει με σειρά.

1. Ελέγξτε αν υπάρχει επιτυχημένη συναλλαγή στο ePay admin.
2. Ελέγξτε το email επιβεβαίωσης της Πειραιώς.
3. Ελέγξτε αν η παραγγελία υπάρχει στο OpenCart ως missing order ή χωρίς κατάσταση.
4. Ελέγξτε αν το success URL είναι σωστό.
5. Ελέγξτε αν το POST request φτάνει στο κατάστημα.
6. Ελέγξτε logs του extension, αν υπάρχουν.
7. Ελέγξτε server error logs.
8. Ελέγξτε αν firewall, CDN, Cloudflare rule, ModSecurity ή security extension μπλοκάρει το request.
9. Ελέγξτε αν υπάρχει redirect από HTTP σε HTTPS, non-www σε www ή άλλο canonical redirect που χάνει POST data.
10. Κάντε νέα demo πληρωμή με τα επίσημα demo στοιχεία της Πειραιώς.
11. Αν έγιναν αλλαγές σε URLs ή domain, ζητήστε από την τράπεζα να επιβεβαιώσει ότι έχουν ενημερωθεί σωστά.

Τεχνικοί όροι με απλά λόγια

Redirect

Η μεταφορά του πελάτη από το OpenCart στο ασφαλές περιβάλλον της τράπεζας.

Payment ticket

Το reference που αντιστοιχεί σε μία συγκεκριμένη προσπάθεια πληρωμής.

POST request

Ο τρόπος με τον οποίο το ePay στέλνει δεδομένα αποτελέσματος πίσω στο OpenCart.

Success URL

Η διεύθυνση του καταστήματος όπου επιστρέφει η τράπεζα μετά τη διαδικασία πληρωμής.

Callback / return URL

Γενικός όρος για το URL που δέχεται την επιστροφή ή ειδοποίηση από την πύλη πληρωμών.

Missing order

Παραγγελία που υπάρχει στο OpenCart αλλά δεν έχει λάβει τελική έγκυρη ενημέρωση κατάστασης.

Order status

Η κατάσταση της παραγγελίας, όπως επιτυχημένη, εκκρεμής, ακυρωμένη ή χωρίς τελική ενημέρωση.

Demo credentials

Δοκιμαστικά στοιχεία σύνδεσης για έλεγχο της ροής χωρίς πραγματική παραγωγική λειτουργία.

Live credentials

Παραγωγικά στοιχεία σύνδεσης που χρησιμοποιούνται στο πραγματικό κατάστημα.