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

Ενσωματώστε την 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: Χειροκίνητη Εγκατάσταση
- Μεταβείτε στον κατάλογο
app/code - Κατεβάστε και αποσυμπιέστε την έκδοση Cost+ από GitHub
- Εκτελέστε τις εντολές ρύθμισης:
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. Ρύθμιση του Πρόσθετου
- Μεταβείτε στα Stores → Configuration → Sales → Payment Methods → Cost+ Payments
- Εισάγετε το κλειδί API σας (δείτε βήμα 3 παρακάτω)
- Ενεργοποιήστε τις μεθόδους πληρωμής που έχετε εγκριθεί
- Αποθηκεύστε τις αλλαγές
- Μεταβείτε στα System → Configuration → Sales → Payment Methods
- Εντοπίστε την ενότητα NoPayn Payment Gateway
- Εισάγετε το κλειδί API σας (δείτε βήμα 3 παρακάτω)
- Ενεργοποιήστε τις επιμέρους μεθόδους πληρωμής (Πιστωτική / Χρεωστική Κάρτα, Apple Pay, Google Pay, Vipps MobilePay)
- Προαιρετικά περιορίστε ανά χώρα
- Αποθηκεύστε τη ρύθμιση
3. Εισαγωγή Διαπιστευτηρίων API
Συνδεθείτε στην Πύλη Εμπόρου και μεταβείτε στα Websites, στη συνέχεια κάντε κλικ στην ιστοσελίδα που θέλετε να συνδέσετε. Κάντε κλικ στο Integration όπου θα βρείτε το κλειδί API σας.

Επικολλήστε το κλειδί API στο πεδίο ρύθμισης και αποθηκεύστε.
Ενεργοποιήστε μόνο τις μεθόδους πληρωμής για τις οποίες έχετε εγκριθεί και λάβει επιβεβαίωση.
Υποστηριζόμενες Μέθοδοι Πληρωμής
| Όνομα Checkout | Αναγνωριστικό NoPayn |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
Ροή Πληρωμής
- Ο πελάτης επιλέγει μέθοδο πληρωμής στο checkout και κάνει την παραγγελία
- Ο πελάτης ανακατευθύνεται στη Φιλοξενούμενη Σελίδα Πληρωμής NoPayn
- Μετά την πληρωμή, ο πελάτης επιστρέφει και η κατάσταση παραγγελίας ενημερώνεται αυτόματα
- Η NoPayn στέλνει webhook για ασύγχρονη επιβεβαίωση κατάστασης
- Ο πελάτης επιλέγει μέθοδο πληρωμής στο checkout και κάνει την παραγγελία
- Η παραγγελία δημιουργείται με κατάσταση Pending Payment
- Ο πελάτης ανακατευθύνεται στην ασφαλή σελίδα πληρωμής NoPayn
- Μετά την πληρωμή:
- Επιτυχία — ο πελάτης επιστρέφει, η κατάσταση επαληθεύεται μέσω API, η παραγγελία ορίζεται σε Processing
- Ακυρώθηκε — ο πελάτης επιστρέφει, η παραγγελία ορίζεται σε Canceled
- Έληξε (χρονικό όριο 5 λεπτών) — ενεργοποιείται webhook, η παραγγελία ορίζεται σε Canceled
- Η NoPayn στέλνει webhook για ασύγχρονη επιβεβαίωση κατάστασης
Αντιστοίχιση Κατάστασης Παραγγελίας
| Κατάσταση NoPayn | Κατάσταση Παραγγελίας Magento | Κατάσταση Παραγγελίας Magento |
|---|---|---|
new | pending_payment | Pending Payment |
processing | pending_payment | Pending Payment |
completed | processing | Processing |
cancelled | canceled | Canceled |
expired | canceled | Canceled |
error | canceled | Canceled |
Webhooks
Το module καταχωρεί ένα endpoint webhook στο /nopayn/payment/webhook. Αυτό το URL στέλνεται αυτόματα στη NoPayn κατά τη δημιουργία παραγγελιών. Το webhook πάντα επαληθεύει την κατάσταση παραγγελίας μέσω του API NoPayn πριν ενημερώσει την παραγγελία Magento.
Δεν απαιτείται χειροκίνητη ρύθμιση webhook — το module χειρίζεται την εγγραφή αυτόματα.
4. Δοκιμάστε τη Ρύθμισή σας
- Κάντε μερικές δοκιμαστικές συναλλαγές — τόσο επιτυχημένες όσο και αποτυχημένες
- Επαληθεύστε ότι όλες οι ενεργοποιημένες μέθοδοι πληρωμής εμφανίζονται στο checkout
- Ρυθμίστε τη συμπεριφορά δέσμευσης (αυτόματη δέσμευση vs. χειροκίνητη) βάσει της διαδικασίας εκπλήρωσής σας
Υποστήριξη
Χρειάζεστε βοήθεια; Επικοινωνήστε με την ομάδα υποστήριξης στο support@costplus.io.