DocsnopCommerce
Ενσωμάτωση Cost+ με το κατάστημα nopCommerce σας χρησιμοποιώντας το επίσημο πρόσθετο πληρωμών
Ενσωματώστε την Cost+ ως μέθοδο πληρωμής στο κατάστημα nopCommerce σας. Το επίσημο πρόσθετο NoPayn Payment Gateway υποστηρίζει πολλαπλές μεθόδους πληρωμής με απευθείας ανακατεύθυνση στην επιλεγμένη μέθοδο πληρωμής — πλήρως συμβατό με PCI DSS.
Προαπαιτούμενα
- Ενεργός λογαριασμός εμπόρου Cost+
- nopCommerce 4.90 ή νεότερο
- .NET 9
- Πρόσβαση διαχειριστή στον πίνακα διαχείρισης nopCommerce
- Πρόσβαση στον πηγαίο κώδικα nopCommerce (για εγκατάσταση πρόσθετου)
Υποστηριζόμενες Μέθοδοι Πληρωμής
| Εμφανιζόμενο Όνομα Checkout | Αναγνωριστικό NoPayn |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
1. Εγκατάσταση του Πρόσθετου
Αντιγράψτε τον φάκελο πρόσθετου στον κατάλογο πηγαίου κώδικα nopCommerce:
src/Plugins/Nop.Plugin.Payments.NoPayn/Προσθέστε το project στη λύση και κάντε build:
dotnet sln add src/Plugins/Nop.Plugin.Payments.NoPayn/Nop.Plugin.Payments.NoPayn.csproj
dotnet buildΣτον πίνακα διαχείρισης nopCommerce:
- Μεταβείτε στα Configuration → Local plugins
- Βρείτε NoPayn Payment Gateway και κάντε κλικ στο Install
- Μεταβείτε στα Configuration → Payment methods
- Ενεργοποιήστε NoPayn Payment Gateway
- Κάντε κλικ στο Configure για να ανοίξετε τις ρυθμίσεις
2. Ρύθμιση του Πρόσθετου
Συνδεθείτε στην Πύλη Εμπόρου και μεταβείτε στα Websites, στη συνέχεια κάντε κλικ στην ιστοσελίδα που θέλετε να συνδέσετε. Κάντε κλικ στο Integration όπου θα βρείτε το κλειδί API σας.
Στη ρύθμιση πρόσθετου, εισάγετε το κλειδί API σας και ενεργοποιήστε τις μεθόδους πληρωμής που θέλετε να προσφέρετε:
| Ρύθμιση | Περιγραφή |
|---|---|
| API Key | Το κλειδί API NoPayn σας |
| Enable Credit / Debit Card | Ενεργοποίηση πληρωμών με πιστωτική/χρεωστική κάρτα |
| Enable Apple Pay | Ενεργοποίηση πληρωμών Apple Pay |
| Enable Google Pay | Ενεργοποίηση πληρωμών Google Pay |
| Enable Vipps MobilePay | Ενεργοποίηση πληρωμών Vipps MobilePay |
Ενεργοποιήστε μόνο τις μεθόδους πληρωμής για τις οποίες έχετε εγκριθεί και λάβει επιβεβαίωση.
3. Ροή Πληρωμής
- Ο πελάτης επιλέγει NoPayn Payment Gateway στο checkout
- Εμφανίζεται επιλογή υπο-μεθόδου (Credit Card, Apple Pay, κ.λπ.)
- Ο πελάτης επιλέγει μέθοδο και επιβεβαιώνει την παραγγελία
- Η παραγγελία δημιουργείται με κατάσταση πληρωμής Pending
- Ο πελάτης ανακατευθύνεται απευθείας στην επιλεγμένη μέθοδο πληρωμής στη σελίδα πληρωμής NoPayn
- Μετά την πληρωμή:
- Επιτυχία — η παραγγελία σημειώνεται ως Paid / Processing
- Ακυρώθηκε / Απέτυχε / Έληξε — η παραγγελία ορίζεται σε Cancelled
- Η NoPayn στέλνει webhook για ασύγχρονη επιβεβαίωση κατάστασης
Οι συναλλαγές λήγουν μετά από 5 λεπτά. Αν ένας πελάτης δεν ολοκληρώσει την πληρωμή εντός αυτού του παραθύρου, η παραγγελία ακυρώνεται αυτόματα μέσω webhook.
4. Αντιστοίχιση Κατάστασης Παραγγελίας
| Κατάσταση NoPayn | Κατάσταση Πληρωμής nopCommerce | Κατάσταση Παραγγελίας nopCommerce |
|---|---|---|
new | Pending | Pending |
processing | Pending | Pending |
completed | Paid | Processing |
cancelled | Voided | Cancelled |
expired | Voided | Cancelled |
error | Voided | Cancelled |
5. Webhooks
Το πρόσθετο καταχωρεί ένα endpoint webhook στο /NoPayn/Webhook. Η NoPayn στέλνει δεδομένα POST που περιέχουν το αναγνωριστικό παραγγελίας σε αλλαγές κατάστασης. Το πρόσθετο επαληθεύει την τρέχουσα κατάσταση μέσω κλήσης API πριν ενημερώσει την παραγγελία.
Δεν απαιτείται χειροκίνητη ρύθμιση webhook — το πρόσθετο χειρίζεται την εγγραφή αυτόματα.
6. Δοκιμή και Εκκίνηση
Κάντε μερικές δοκιμαστικές συναλλαγές για να βεβαιωθείτε ότι όλα λειτουργούν ομαλά. Προτείνουμε να δοκιμάσετε τόσο επιτυχημένες όσο και αποτυχημένες πληρωμές για να επιβεβαιώσετε ότι όλα τα σενάρια αντιμετωπίζονται σωστά.
Υποστήριξη
Χρειάζεστε βοήθεια; Επικοινωνήστε με την ομάδα υποστήριξης στο support@costplus.io.