DocsShopware
Ενσωμάτωση Cost+ με το κατάστημα Shopware 6 σας χρησιμοποιώντας το επίσημο πρόσθετο πληρωμών
Ενσωματώστε την Cost+ ως μέθοδο πληρωμής στο κατάστημα Shopware 6 σας. Το επίσημο πρόσθετο NoPayn Payment υποστηρίζει πολλαπλές μεθόδους πληρωμής ανά κανάλι πωλήσεων και χρησιμοποιεί τη ροή Φιλοξενούμενης Σελίδας Πληρωμής — πλήρως συμβατό με PCI DSS.
Προαπαιτούμενα
- Ενεργός λογαριασμός εμπόρου Cost+
- Shopware 6.7 ή νεότερο
- PHP 8.2 ή νεότερη
- Πρόσβαση SSH ή τερματικού στον διακομιστή Shopware
Υποστηριζόμενες Μέθοδοι Πληρωμής
| Όνομα Checkout | Τεχνικό Όνομα | Αναγνωριστικό NoPayn |
|---|---|---|
| Credit / Debit Card | nopayn_credit_card | credit-card |
| Apple Pay | nopayn_apple_pay | apple-pay |
| Google Pay | nopayn_google_pay | google-pay |
| Vipps MobilePay | nopayn_vipps_mobilepay | vipps-mobilepay |
Κάθε μέθοδος μπορεί να ενεργοποιηθεί ή απενεργοποιηθεί ανά κανάλι πωλήσεων από τη ρύθμιση πρόσθετου.
1. Εγκατάσταση του Πρόσθετου
Κλωνοποιήστε ή αντιγράψτε το πρόσθετο στον κατάλογο custom/plugins/ του Shopware:
cd /path/to/shopware/custom/plugins
git clone git@github.com:NoPayn/shopware.git NoPaynPaymentΣτη συνέχεια εγκαταστήστε και ενεργοποιήστε μέσω του Shopware CLI:
bin/console plugin:refresh
bin/console plugin:install NoPaynPayment --activate
bin/console cache:clear2. Ρύθμιση του Πρόσθετου
- Στη διαχείριση Shopware, μεταβείτε στα Settings → Extensions → NoPayn Payment
- Εισάγετε το κλειδί API σας από την Πύλη Εμπόρου — μεταβείτε στα Websites, κάντε κλικ στην ιστοσελίδα που θέλετε να συνδέσετε, στη συνέχεια κάντε κλικ στο Integration για να βρείτε το κλειδί API σας
- Ενεργοποιήστε ή απενεργοποιήστε ξεχωριστές μεθόδους πληρωμής
- Αποθηκεύστε
Μπορείτε να ρυθμίσετε διαφορετικό κλειδί API ανά κανάλι πωλήσεων αν λειτουργείτε πολλαπλά καταστήματα.
Ενεργοποιήστε μόνο τις μεθόδους πληρωμής για τις οποίες έχετε εγκριθεί και λάβει επιβεβαίωση.
3. Ροή Πληρωμής
- Ο πελάτης επιλέγει μέθοδο πληρωμής στο checkout και κάνει την παραγγελία
- Η παραγγελία δημιουργείται με κατάσταση συναλλαγής in_progress
- Ο πελάτης ανακατευθύνεται στη Φιλοξενούμενη Σελίδα Πληρωμής NoPayn
- Μετά την πληρωμή:
- Επιτυχία — ο πελάτης επιστρέφει, η κατάσταση επαληθεύεται μέσω API, η συναλλαγή ορίζεται σε paid, η παραγγελία σε processing
- Ακυρώθηκε — ο πελάτης επιστρέφει, η συναλλαγή και η παραγγελία ορίζονται σε cancelled
- Έληξε (χρονικό όριο 5 λεπτών) — ενεργοποιείται webhook, η συναλλαγή και η παραγγελία ορίζονται σε cancelled
4. Αντιστοίχιση Κατάστασης Παραγγελίας
| Κατάσταση NoPayn | Κατάσταση Συναλλαγής | Κατάσταση Παραγγελίας |
|---|---|---|
new | in_progress | open |
processing | in_progress | open |
completed | paid | in_progress |
cancelled | cancelled | cancelled |
expired | cancelled | cancelled |
error | cancelled | cancelled |
5. Webhooks
Το πρόσθετο καταχωρεί αυτόματα ένα endpoint webhook στο /api/nopayn/webhook. Αυτό το URL στέλνεται στη NoPayn κατά τη δημιουργία παραγγελιών, παρέχοντας ασύγχρονη επιβεβαίωση κατάστασης για όλες τις συναλλαγές.
Δεν απαιτείται χειροκίνητη ρύθμιση webhook — το πρόσθετο χειρίζεται την εγγραφή αυτόματα.
6. Δοκιμή και Εκκίνηση
Κάντε μερικές δοκιμαστικές συναλλαγές για να βεβαιωθείτε ότι όλα λειτουργούν ομαλά. Προτείνουμε να δοκιμάσετε τόσο επιτυχημένες όσο και αποτυχημένες πληρωμές για να επιβεβαιώσετε ότι όλα τα σενάρια αντιμετωπίζονται σωστά.
Υποστήριξη
Χρειάζεστε βοήθεια; Επικοινωνήστε με την ομάδα υποστήριξης στο support@costplus.io.