Cost+Docs

OpenCart

Ενσωμάτωση Cost+ με το κατάστημα OpenCart σας (4.x και 3.x / ocStore 3)

OpenCart

Ενσωματώστε την Cost+ ως μέθοδο πληρωμής στο κατάστημα OpenCart σας. Η επίσημη επέκταση NoPayn Payment Gateway είναι διαθέσιμη για OpenCart 4 και OpenCart 3 / ocStore 3.

Προαπαιτούμενα

  • Ενεργός λογαριασμός εμπόρου Cost+
  • OpenCart 4.0.0.0 ή νεότερο
  • PHP 8.0 ή νεότερη
  • Πρόσβαση διαχειριστή στον πίνακα ελέγχου OpenCart
  • Ενεργός λογαριασμός εμπόρου Cost+
  • ocStore 3.0.x ή OpenCart 3.0.3.x
  • PHP 7.4 ή νεότερη
  • Πρόσβαση διαχειριστή στον πίνακα ελέγχου OpenCart

Υποστηριζόμενες Μέθοδοι Πληρωμής

  • Πιστωτική / Χρεωστική Κάρτα — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
  • Apple Pay
  • Google Pay
  • Vipps / MobilePay
  • Πιστωτική / Χρεωστική Κάρτα — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
  • Apple Pay
  • Google Pay
  • Vipps / MobilePay
  • Swish

1. Εγκατάσταση της Επέκτασης

Μέθοδος A: Μεταφόρτωση μέσω Πίνακα Διαχείρισης (Συνιστάται)

  1. Κατεβάστε την τελευταία έκδοση .ocmod.zip από το GitHub
  2. Στη διαχείριση OpenCart, μεταβείτε στα Extensions → Installer
  3. Ανεβάστε το αρχείο .ocmod.zip
  4. Μεταβείτε στα Extensions → Extensions → Payment
  5. Βρείτε NoPayn Payment Gateway και κάντε κλικ στο Install και μετά Edit

Μέθοδος B: Χειροκίνητη Μεταφόρτωση

  1. Κατεβάστε ή κλωνοποιήστε το αποθετήριο
  2. Αντιγράψτε τα περιεχόμενα του φακέλου upload/ στον ριζικό κατάλογο OpenCart
  3. Μεταβείτε στα Extensions → Extensions → Payment
  4. Βρείτε NoPayn Payment Gateway και κάντε κλικ στο Install και μετά Edit

Αρχιτεκτονική

Το OpenCart 3 χρησιμοποιεί ρύθμιση πολλαπλών επεκτάσεων:

  • NoPayn - Global Settings — κοινόχρηστη ρύθμιση (κλειδί API, καταστάσεις παραγγελιών, διαθεσιμότητα μεθόδων, χειροκίνητη δέσμευση, καταγραφή αποσφαλμάτωσης)
  • NoPayn - Card Payments — checkout πιστωτικής/χρεωστικής κάρτας
  • NoPayn - Apple Pay / Google Pay — checkout πορτοφολιού (αν είναι ενεργοποιημένο μόνο ένα πορτοφόλι, η ετικέτα προσαρμόζεται αυτόματα)
  • NoPayn - Vipps MobilePay — checkout Vipps/MobilePay
  • NoPayn - Swish — checkout Swish

Μέθοδος A: Μεταφόρτωση μέσω Πίνακα Διαχείρισης (Συνιστάται)

  1. Κατεβάστε το αρχείο .ocmod.zip από την τελευταία έκδοση GitHub

Χρησιμοποιήστε το αρχείο .ocmod.zip από την έκδοση — όχι τα αυτόματα δημιουργημένα αρχεία "Source code" του GitHub, που περιέχουν τη δομή αποθετηρίου, όχι τη δομή εγκατάστασης.

  1. Στη διαχείριση, μεταβείτε στα Extensions → Installer
  2. Ανεβάστε το αρχείο .ocmod.zip
  3. Μεταβείτε στα Extensions → Extensions → Payments
  4. Εγκαταστήστε πρώτα NoPayn - Global Settings
  5. Ανοίξτε NoPayn - Global Settings και ρυθμίστε:
    • Κλειδί API
    • Καταστάσεις παραγγελιών ολοκληρωμένες, εκκρεμείς και ακυρωμένες
    • Διαθέσιμες μέθοδοι πληρωμής για τις οποίες ο λογαριασμός εμπόρου σας έχει εγκριθεί
    • Προαιρετικά: χειροκίνητη δέσμευση κάρτας
    • Προαιρετικά: καταγραφή αποσφαλμάτωσης
  6. Εγκαταστήστε τα modules checkout που θέλετε να εκθέσετε:
    • NoPayn - Card Payments
    • NoPayn - Apple Pay / Google Pay
    • NoPayn - Vipps MobilePay
    • NoPayn - Swish
  7. Για κάθε module checkout, ορίστε: Status, Geo Zone και Sort Order

Μέθοδος B: Χειροκίνητη Μεταφόρτωση

  1. Κατεβάστε ή κλωνοποιήστε το αποθετήριο
  2. Αντιγράψτε τα περιεχόμενα του φακέλου upload/ στον ριζικό κατάλογο του καταστήματος
  3. Μεταβείτε στα Extensions → Extensions → Payments
  4. Ακολουθήστε την ίδια σειρά εγκατάστασης με τη Μέθοδο A (πρώτα Global Settings, μετά τα modules checkout)

2. Εισαγωγή Διαπιστευτηρίων API

Συνδεθείτε στην Πύλη Εμπόρου και μεταβείτε στα Websites, στη συνέχεια κάντε κλικ στην ιστοσελίδα που θέλετε να συνδέσετε. Κάντε κλικ στο Integration όπου θα βρείτε το κλειδί API σας.

Πύλη Εμπόρου Cost+ εμφανίζοντας κλειδί API

Στις ρυθμίσεις NoPayn Payment Gateway, εισάγετε το κλειδί API στο αντίστοιχο πεδίο.

Στα NoPayn - Global Settings, εισάγετε το κλειδί API στο αντίστοιχο πεδίο. Το κλειδί API είναι κοινόχρηστο σε όλα τα modules checkout — χρειάζεται να το εισάγετε μόνο μία φορά.

3. Ρύθμιση Πληρωμών

  1. Ενεργοποιήστε τις μεθόδους πληρωμής για τις οποίες έχετε εγκριθεί
  2. Ορίστε τις επιθυμητές καταστάσεις παραγγελιών για ολοκληρωμένες, εκκρεμείς και ακυρωμένες πληρωμές
  3. Προαιρετικά περιορίστε τις πληρωμές ανά Geo Zone
  4. Ορίστε Status σε Enabled
  5. Κάντε κλικ στο Save

Καθολικές Ρυθμίσεις

Τα NoPayn - Global Settings αποθηκεύουν όλη την κοινόχρηστη ρύθμιση:

ΡύθμισηΠεριγραφή
API KeyΤο κλειδί API NoPayn σας
Order StatusesΑντιστοίχιση καταστάσεων ολοκληρωμένων, εκκρεμών και ακυρωμένων
Method AvailabilityΠοιες μέθοδοι πληρωμής ο λογαριασμός εμπόρου σας έχει εγκριθεί
Manual CaptureΕξουσιοδότηση πληρωμών πιστωτικής κάρτας μόνο — δέσμευση αργότερα
Debug LoggingΕνεργοποίηση λεπτομερούς καταγραφής για αντιμετώπιση προβλημάτων

Ρυθμίσεις Module Checkout

Κάθε module checkout έχει τις δικές του ρυθμίσεις καταστήματος:

ΡύθμισηΠεριγραφή
StatusΕνεργοποίηση ή απενεργοποίηση αυτής της μεθόδου πληρωμής στο checkout
Geo ZoneΠεριορισμός σε συγκεκριμένες γεωγραφικές ζώνες
Sort OrderΣειρά εμφάνισης στη σελίδα checkout

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

Ροή Πληρωμής

  1. Ο πελάτης επιλέγει μέθοδο πληρωμής Cost+ στο checkout
  2. Ο πελάτης ανακατευθύνεται στη Φιλοξενούμενη Σελίδα Πληρωμής NoPayn
  3. Μετά την πληρωμή, ο πελάτης επιστρέφει και η κατάσταση παραγγελίας ενημερώνεται αυτόματα
  4. Η NoPayn στέλνει webhook για ασύγχρονη επιβεβαίωση κατάστασης

Η επέκταση χρησιμοποιεί τη Φιλοξενούμενη Σελίδα Πληρωμής Cost+, που σημαίνει ότι οι πελάτες ανακατευθύνονται σε μια ασφαλή φόρμα πληρωμής. Κανένα ευαίσθητο δεδομένο κάρτας δεν διαχειρίζεται ο διακομιστής σας.

Κάθε module checkout είναι ξεχωριστή επέκταση πληρωμής OpenCart, δίνοντας στους πελάτες ξεχωριστές επιλογές radio στο checkout (π.χ. "Card Payments", "Apple Pay & Google Pay").

  1. Ο πελάτης επιλέγει ετικέτα μεθόδου πληρωμής στο checkout (π.χ. Card Payments)
  2. Η επέκταση δημιουργεί μια φιλοξενούμενη παραγγελία πληρωμής NoPayn
  3. Ο πελάτης ανακατευθύνεται στην ασφαλή σελίδα πληρωμής NoPayn
  4. Μετά την πληρωμή, ο πελάτης επιστρέφει και η κατάσταση παραγγελίας ενημερώνεται αυτόματα
  5. Η NoPayn στέλνει webhook για ασύγχρονη επιβεβαίωση κατάστασης

Το module Apple Pay / Google Pay στέλνει και τις δύο μεθόδους σε μία συναλλαγή ώστε η φιλοξενούμενη σελίδα NoPayn να μπορεί να προσφέρει και τις δύο επιλογές πορτοφολιού σε μία ροή.

Αναβάθμιση από v1.0.0 σε v2.0.0

Η έκδοση 1.0.0 χρησιμοποιούσε μία μέθοδο checkout με τίτλο "NoPayn Checkout". Η έκδοση 2.0.0 αλλάζει σε ξεχωριστά modules checkout ανά μέθοδο πληρωμής. Κατά την αναβάθμιση:

  1. Ανεβάστε το νέο πακέτο
  2. Η υπάρχουσα εγγραφή "NoPayn Checkout" γίνεται NoPayn - Global Settings
  3. Ελέγξτε και αποθηκεύστε τις καθολικές ρυθμίσεις
  4. Εγκαταστήστε και ενεργοποιήστε τα νέα modules checkout που θέλετε να βλέπουν οι πελάτες

4. Δοκιμή και Εκκίνηση

Κάντε μερικές δοκιμαστικές συναλλαγές για να βεβαιωθείτε ότι όλα λειτουργούν ομαλά. Προτείνουμε να δοκιμάσετε τόσο επιτυχημένες όσο και αποτυχημένες πληρωμές για να επιβεβαιώσετε ότι όλα τα σενάρια αντιμετωπίζονται σωστά.

Υποστήριξη

Χρειάζεστε βοήθεια; Επικοινωνήστε με την ομάδα υποστήριξης στο support@costplus.io.

On this page