Drupal Commerce

Ενσωματώστε την Cost+ ως μέθοδο πληρωμής στο κατάστημα Drupal Commerce σας. Το επίσημο module NoPayn Payment Gateway χρησιμοποιεί τη ροή Φιλοξενούμενης Σελίδας Πληρωμής, οπότε κανένα δεδομένο κάρτας δεν αγγίζει τον διακομιστή σας — πλήρως συμβατό με PCI DSS.

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

• Ενεργός λογαριασμός εμπόρου Cost+
• Drupal 10 ή 11
• Drupal Commerce 3.x
• PHP 8.1 ή νεότερη
• Πρόσβαση διαχειριστή στον ιστότοπο Drupal σας

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

• Πιστωτική / Χρεωστική Κάρτα — Visa, Mastercard και άλλες
• Apple Pay
• Google Pay
• Vipps / MobilePay

1. Εγκατάσταση του Module

Αντιγράψτε το module commerce_nopayn στην εγκατάσταση Drupal σας και ενεργοποιήστε το:

cp -r commerce_nopayn /path/to/drupal/web/modules/custom/
drush en commerce_nopayn -y
drush cr

2. Προσθήκη Πύλης Πληρωμών

1. Μεταβείτε στα Commerce → Configuration → Payment gateways (/admin/commerce/config/payment-gateways)
2. Κάντε κλικ στο Add payment gateway
3. Επιλέξτε NoPayn Payment Gateway ως πρόσθετο

3. Ρύθμιση της Πύλης

Εισάγετε τις ακόλουθες ρυθμίσεις:

• NoPayn API Key — Το κλειδί API εμπόρου σας από την Πύλη Εμπόρου
• Payment Methods — Ενεργοποιήστε ή απενεργοποιήστε Credit Card, Apple Pay, Google Pay, Vipps MobilePay
• Mode — Ορίστε σε Test όταν χρησιμοποιείτε κλειδί API από ιστοσελίδα sandbox, ή Live όταν χρησιμοποιείτε κλειδί ιστοσελίδας production

Προαιρετικές Ρυθμίσεις

• Manual Capture — Εξουσιοδότηση πληρωμών πιστωτικής κάρτας χωρίς άμεση δέσμευση (τα κεφάλαια δεσμεύονται, μετά δεσμεύονται όταν εκτελεστεί η παραγγελία)
• Debug Logging — Ενεργοποιήστε για καταγραφή όλων των αιτημάτων και αποκρίσεων API στο log του Drupal για αντιμετώπιση προβλημάτων

Κάντε κλικ στο Save όταν τελειώσετε.

4. Ροή Πληρωμής

Μόλις ρυθμιστεί, η ροή πληρωμής λειτουργεί ως εξής:

1. Ο πελάτης προσθέτει προϊόντα στο καλάθι και προχωρά στο checkout
2. Στο βήμα πληρωμής, οι ενεργοποιημένες μέθοδοι Cost+ εμφανίζονται ως radio buttons
3. Ο πελάτης επιλέγει μέθοδο και επιβεβαιώνει την παραγγελία
4. Το module δημιουργεί παραγγελία μέσω του API Cost+ και ανακατευθύνει στη φιλοξενούμενη σελίδα πληρωμής
5. Ο πελάτης ολοκληρώνει την πληρωμή στη σελίδα Cost+
6. Ο πελάτης επιστρέφει στο κατάστημα — η πληρωμή επαληθεύεται μέσω API
7. Ένα webhook από την Cost+ επιβεβαιώνει ασύγχρονα το αποτέλεσμα πληρωμής

5. Ρύθμιση Webhook

Το URL webhook δημιουργείται αυτόματα από το Drupal Commerce:

https://your-store.com/payment/notify/{gateway_machine_name}

Για παράδειγμα: https://your-store.com/payment/notify/nopayn

Αυτό το URL πρέπει να είναι προσβάσιμο από το διαδίκτυο χωρίς αυθεντικοποίηση. Το module πάντα επαληθεύει την κατάσταση πληρωμής μέσω API — δεν εμπιστεύεται ποτέ μόνο το payload webhook.

Χειροκίνητη Δέσμευση

Όταν η χειροκίνητη δέσμευση είναι ενεργοποιημένη για πιστωτικές κάρτες:

1. Η κάρτα του πελάτη εξουσιοδοτείται (τα κεφάλαια δεσμεύονται) κατά το checkout
2. Η δέσμευση γίνεται αυτόματα όταν η παραγγελία μεταβεί σε Fulfilled
3. Αν η παραγγελία ακυρωθεί, η εξουσιοδότηση ακυρώνεται μέσω webhook

Επιστροφές Χρημάτων

Οι επιστροφές χρημάτων μπορούν να γίνουν απευθείας από τον πίνακα διαχείρισης Commerce. Υποστηρίζονται τόσο πλήρεις όσο και μερικές επιστροφές χρημάτων.

Πίνακες Βάσης Δεδομένων

Το module δημιουργεί δύο πίνακες για παρακολούθηση:

Απεγκατάσταση

drush pmu commerce_nopayn -y
drush cr

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

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

Υποστήριξη

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