Cost+Docs

Magento

Ενσωμάτωση Cost+ με το κατάστημα Magento σας (2.x και 1.9 / OpenMage LTS)

Magento

Ενσωματώστε την Cost+ ως μέθοδο πληρωμής στο κατάστημα Magento σας. Η επέκταση Cost+ είναι διαθέσιμη για Magento 2 (2.4.6 – 2.4.8) και Magento 1.9 (συμπεριλαμβανομένου OpenMage LTS 20+).

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

  • Ενεργός λογαριασμός εμπόρου Cost+
  • Εγκατάσταση Magento 2.4.6 – 2.4.8
  • PHP 8.2 – 8.4
  • Πρόσβαση διαχειριστή στον πίνακα διαχείρισης Magento
  • Πρόσβαση SSH στον διακομιστή σας (για εγκατάσταση μέσω Composer)
  • Ενεργός λογαριασμός εμπόρου Cost+
  • Magento 1.9.x ή OpenMage LTS 20+
  • PHP 7.4 ή νεότερη
  • Πρόσβαση διαχειριστή στον πίνακα διαχείρισης Magento
  • Πρόσβαση SSH ή FTP στον διακομιστή σας

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

Μέθοδος A: Εγκατάσταση μέσω Composer (Συνιστάται)

Συνδεθείτε στον διακομιστή Magento μέσω SSH και μεταβείτε στον ριζικό κατάλογο Magento.

Εγκαταστήστε το πρόσθετο:

composer require nopayn/nopayn-magento-2

Εκτελέστε τις εντολές ρύθμισης Magento:

php bin/magento setup:upgrade
php bin/magento module:enable GingerPay_Payment
php bin/magento cache:clean

Αν βρίσκεστε σε λειτουργία production, εκτελέστε επίσης:

php bin/magento setup:static-content:deploy

Μέθοδος B: Χειροκίνητη Εγκατάσταση

  1. Μεταβείτε στον κατάλογο app/code
  2. Κατεβάστε και αποσυμπιέστε την έκδοση Cost+ από GitHub
  3. Εκτελέστε τις εντολές ρύθμισης:
php bin/magento setup:upgrade
php bin/magento cache:clean

Αν είστε σε λειτουργία production:

php bin/magento setup:static-content:deploy

Κατεβάστε ή κλωνοποιήστε το module από το GitHub.

Αντιγράψτε τα περιεχόμενα του app/ στον ριζικό κατάλογο app/ του Magento σας:

cp -r app/* /path/to/magento/app/

Καθαρίστε την cache του Magento:

rm -rf var/cache/*

Συνδεθείτε στον πίνακα διαχείρισης Magento και μεταβείτε στα System → Configuration → Sales → Payment Methods για να επαληθεύσετε ότι εμφανίζεται η ενότητα NoPayn Payment Gateway.

Το module δημιουργεί έναν πίνακα nopayn_transactions στη βάση δεδομένων σας για παρακολούθηση συναλλαγών πληρωμής. Αυτός δημιουργείται αυτόματα κατά την πρώτη χρήση.

2. Ρύθμιση του Πρόσθετου

  1. Μεταβείτε στα Stores → Configuration → Sales → Payment Methods → Cost+ Payments
  2. Εισάγετε το κλειδί API σας (δείτε βήμα 3 παρακάτω)
  3. Ενεργοποιήστε τις μεθόδους πληρωμής που έχετε εγκριθεί
  4. Αποθηκεύστε τις αλλαγές
  1. Μεταβείτε στα System → Configuration → Sales → Payment Methods
  2. Εντοπίστε την ενότητα NoPayn Payment Gateway
  3. Εισάγετε το κλειδί API σας (δείτε βήμα 3 παρακάτω)
  4. Ενεργοποιήστε τις επιμέρους μεθόδους πληρωμής (Πιστωτική / Χρεωστική Κάρτα, Apple Pay, Google Pay, Vipps MobilePay)
  5. Προαιρετικά περιορίστε ανά χώρα
  6. Αποθηκεύστε τη ρύθμιση

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

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

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

Επικολλήστε το κλειδί API στο πεδίο ρύθμισης και αποθηκεύστε.

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

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

Όνομα CheckoutΑναγνωριστικό NoPayn
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-mobilepay

Ροή Πληρωμής

  1. Ο πελάτης επιλέγει μέθοδο πληρωμής στο checkout και κάνει την παραγγελία
  2. Ο πελάτης ανακατευθύνεται στη Φιλοξενούμενη Σελίδα Πληρωμής NoPayn
  3. Μετά την πληρωμή, ο πελάτης επιστρέφει και η κατάσταση παραγγελίας ενημερώνεται αυτόματα
  4. Η NoPayn στέλνει webhook για ασύγχρονη επιβεβαίωση κατάστασης
  1. Ο πελάτης επιλέγει μέθοδο πληρωμής στο checkout και κάνει την παραγγελία
  2. Η παραγγελία δημιουργείται με κατάσταση Pending Payment
  3. Ο πελάτης ανακατευθύνεται στην ασφαλή σελίδα πληρωμής NoPayn
  4. Μετά την πληρωμή:
    • Επιτυχία — ο πελάτης επιστρέφει, η κατάσταση επαληθεύεται μέσω API, η παραγγελία ορίζεται σε Processing
    • Ακυρώθηκε — ο πελάτης επιστρέφει, η παραγγελία ορίζεται σε Canceled
    • Έληξε (χρονικό όριο 5 λεπτών) — ενεργοποιείται webhook, η παραγγελία ορίζεται σε Canceled
  5. Η NoPayn στέλνει webhook για ασύγχρονη επιβεβαίωση κατάστασης

Αντιστοίχιση Κατάστασης Παραγγελίας

Κατάσταση NoPaynΚατάσταση Παραγγελίας MagentoΚατάσταση Παραγγελίας Magento
newpending_paymentPending Payment
processingpending_paymentPending Payment
completedprocessingProcessing
cancelledcanceledCanceled
expiredcanceledCanceled
errorcanceledCanceled

Webhooks

Το module καταχωρεί ένα endpoint webhook στο /nopayn/payment/webhook. Αυτό το URL στέλνεται αυτόματα στη NoPayn κατά τη δημιουργία παραγγελιών. Το webhook πάντα επαληθεύει την κατάσταση παραγγελίας μέσω του API NoPayn πριν ενημερώσει την παραγγελία Magento.

Δεν απαιτείται χειροκίνητη ρύθμιση webhook — το module χειρίζεται την εγγραφή αυτόματα.

4. Δοκιμάστε τη Ρύθμισή σας

  1. Κάντε μερικές δοκιμαστικές συναλλαγές — τόσο επιτυχημένες όσο και αποτυχημένες
  2. Επαληθεύστε ότι όλες οι ενεργοποιημένες μέθοδοι πληρωμής εμφανίζονται στο checkout
  3. Ρυθμίστε τη συμπεριφορά δέσμευσης (αυτόματη δέσμευση vs. χειροκίνητη) βάσει της διαδικασίας εκπλήρωσής σας

Υποστήριξη

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

On this page