osCommerce

Ενσωμάτωση Cost+ με το κατάστημα osCommerce 4 σας χρησιμοποιώντας το επίσημο module πληρωμών

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

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

Ενεργός λογαριασμός εμπόρου Cost+
osCommerce 4.x
PHP 8.1 ή νεότερη
Ενεργοποιημένη επέκταση cURL
Πιστοποιητικό SSL (απαιτείται HTTPS)
Πρόσβαση διαχειριστή στον πίνακα διαχείρισης osCommerce

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

Ετικέτα Checkout	Αναγνωριστικό NoPayn
Credit / Debit Card	`credit-card`
Apple Pay	`apple-pay`
Google Pay	`google-pay`
Vipps MobilePay	`vipps-mobilepay`

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

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

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

Αντιγράψτε τον κατάλογο lib/ στον ριζικό κατάλογο osCommerce 4:

cp -r lib/ /path/to/oscommerce/

Αυτό τοποθετεί τα αρχεία module στο:

lib/common/modules/orderPayment/nopayn.php
lib/common/modules/orderPayment/nopayn/NoPaynApiClient.php
lib/common/modules/orderPayment/nopayn/NoPaynLogger.php
lib/common/modules/orderPayment/nopayn/NoPaynWebhookHandler.php

Στον πίνακα διαχείρισης osCommerce:

Μεταβείτε στα Modules → Payment → Online
Ενεργοποιήστε τα φίλτρα "Show inactive" και "Show not installed" αν χρειάζεται
Βρείτε NoPayn Payments και κάντε κλικ στο Install

2. Ρύθμιση του Module

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

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

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

Ρύθμιση	Περιγραφή	Προεπιλογή
Enable NoPayn Payments	Κεντρικός διακόπτης ενεργοποίησης/απενεργοποίησης	True
API Key	Το κλειδί API NoPayn σας	—
Enable Credit / Debit Card	Εμφάνιση πιστωτικής/χρεωστικής κάρτας στο checkout	True
Enable Apple Pay	Εμφάνιση Apple Pay στο checkout	True
Enable Google Pay	Εμφάνιση Google Pay στο checkout	True
Enable Vipps MobilePay	Εμφάνιση Vipps MobilePay στο checkout	True
Manual Capture (Credit Card)	Μόνο εξουσιοδότηση — δέσμευση όταν ολοκληρωθεί η παραγγελία	False
Debug Logging	Εγγραφή αιτημάτων/αποκρίσεων API στο log	False
Completed Order Status	Κατάσταση που ορίζεται όταν πετυχαίνει η πληρωμή	Processing
Pending Order Status	Κατάσταση που ορίζεται κατά την αναμονή πληρωμής	Pending
Cancelled Order Status	Κατάσταση που ορίζεται σε ακύρωση/αποτυχία/λήξη	Cancelled
Payment Zone	Περιορισμός σε γεωγραφική ζώνη (προαιρετικά)	Όλες οι ζώνες
Sort Order	Σειρά εμφάνισης στη σελίδα checkout	0

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

3. Ενημέρωση Ετικετών Checkout (Συνιστάται)

Οι προεπιλεγμένες ετικέτες κουμπιών checkout osCommerce προϋποθέτουν ροή ενός βήματος. Για καλύτερη εμπειρία με την ανακατεύθυνση πληρωμής εκτός ιστοτόπου, ενημερώστε αυτές τις μεταφράσεις στα Admin → Localisation → Languages → English → Define:

Κλειδί	Προεπιλογή	Συνιστάται
`TEXT_PAY_WITH_CARD`	Pay with card	Go to payment
`TEXT_CONFIRM_AND_PAY`	Confirm and pay	Review order
`CONFIRM_ORDER`	Confirm order	Confirm and pay

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

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

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

Ο πελάτης επιλέγει μέθοδο πληρωμής Cost+ στο checkout
Ο πελάτης επιβεβαιώνει την παραγγελία
Το module δημιουργεί εκκρεμή παραγγελία και καλεί το API Cost+
Ο πελάτης ανακατευθύνεται στη Φιλοξενούμενη Σελίδα Πληρωμής Cost+ (HPP)
Ο πελάτης ολοκληρώνει την πληρωμή στην ασφαλή HPP
Ο πελάτης ανακατευθύνεται πίσω στο κατάστημα
Το module επαληθεύει την κατάσταση πληρωμής μέσω του API Cost+
Η κατάσταση παραγγελίας ενημερώνεται ανάλογα

Οι σύνδεσμοι πληρωμής λήγουν μετά από 5 λεπτά. Αν ο πελάτης δεν ολοκληρώσει την πληρωμή εντός αυτού του παραθύρου, η παραγγελία σημειώνεται αυτόματα ως ακυρωμένη.

5. Webhooks

Το module καταχωρεί ένα URL webhook στην Cost+ για ενημερώσεις κατάστασης διακομιστή-προς-διακομιστή. Όταν αλλάζει η κατάσταση πληρωμής, η Cost+ στέλνει ειδοποίηση και το module:

Λαμβάνει το webhook POST
Επαληθεύει την κατάσταση πληρωμής μέσω API (δεν εμπιστεύεται ποτέ το payload webhook)
Ενημερώνει την κατάσταση παραγγελίας στο osCommerce

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

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

Όταν ενεργοποιηθεί για πληρωμές πιστωτικής κάρτας:

Η πληρωμή εξουσιοδοτείται αλλά δεν δεσμεύεται στο checkout
Τα κεφάλαια δεσμεύονται όταν η παραγγελία μεταβεί σε κατάσταση completed
Αν η παραγγελία ακυρωθεί, η εξουσιοδότηση ακυρώνεται αυτόματα

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

Καταγραφή Αποσφαλμάτωσης

Όταν η Debug Logging είναι ενεργοποιημένη, το module γράφει στο nopayn_debug.log στον κατάλογο logs του osCommerce. Οι εγγραφές περιλαμβάνουν:

Όλα τα αιτήματα και αποκρίσεις API
Συμβάντα webhook και αποτελέσματα επεξεργασίας
Λειτουργίες δέσμευσης και ακύρωσης
Σφάλματα (καταγράφονται πάντα, ανεξάρτητα από τον διακόπτη αποσφαλμάτωσης)

Όλες οι εγγραφές έχουν πρόθεμα NoPayn_ για εύκολο φιλτράρισμα.

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

Μεταβείτε στα Modules → Payment → Online στον πίνακα διαχείρισης
Επιλέξτε NoPayn Payments
Κάντε κλικ στο Remove

Η απεγκατάσταση του module αφαιρεί τη ρύθμιση και διαγράφει τους πίνακες βάσης δεδομένων nopayn_transactions και nopayn_refunds. Βεβαιωθείτε ότι εξάγετε τα δεδομένα που χρειάζεστε πριν την απεγκατάσταση.

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

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

Υποστήριξη

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

On this page