Οδηγός εγκατάστασης & ρύθμισης: WooCommerce Έντοκες Δόσεις

Plugin για WooCommerce που προσθέτει πλάνα έντοκων δόσεων στο checkout και υπολογίζει αυτόματα τον τόκο ως ξεχωριστή χρέωση της παραγγελίας.

Εγκατάσταση και ρύθμιση του WooCommerce Έντοκες Δόσεις

Ο οδηγός αφορά την έκδοση 1.0.0. Η OBS κάνει δωρεάν την εγκατάσταση και τη ρύθμιση των πλάνων.

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

WordPress 6.6+, WooCommerce 8.5+, PHP 7.4+.
Ενεργές δόσεις στη σύμβαση e-commerce με την τράπεζα ή τον πάροχό σας, με τον μέγιστο αριθμό δόσεων που σας έχει εγκριθεί.
Απόφαση για τα επιτόκια ανά πλάνο, σε συνεννόηση με τον λογιστή σας.

Εγκατάσταση

Κατεβάστε το ZIP obs-woocommerce-installments-1.0.0.zip από τον λογαριασμό σας στην OBS.
WordPress → Plugins → Add New → Upload Plugin → Install Now → Activate. Το plugin ξεκινά μόνο αν το WooCommerce είναι ενεργό.
Αν είχατε την παλαιότερη έκδοση («OBS add Installments Fees»), μην έχετε και τις δύο ενεργές. Η 1.0.0 χρησιμοποιεί νέες ρυθμίσεις και δεν μεταφέρει αυτόματα τα παλιά επιτόκια.

Χάρτης ρυθμίσεων (WooCommerce → Interest Installments)

Πεδίο	Τι κάνει	Προεπιλογή
Enabled	Ενεργοποιεί τις δόσεις στο checkout.	Ανενεργό
Explicit gateway IDs	Τα IDs των πυλών πληρωμών, χωρισμένα με κόμμα, όπου εμφανίζονται οι δόσεις. Κάθε πύλη χρειάζεται και υποστήριξη (adapter) για το plugin.	Κενό
Rules JSON	Λίστα πλάνων με `count` (2–60 δόσεις), `rate_bps` (0–10000, π.χ. 300 = 3%) και προαιρετικό `label`.	`[{"count":3,"rate_bps":300,"label":"3 installments (+3%)"}]`

Παράδειγμα κανόνων με ελληνικές ετικέτες:

[
  {"count":3,"rate_bps":300,"label":"3 δόσεις (+3%)"},
  {"count":6,"rate_bps":550,"label":"6 δόσεις (+5,5%)"},
  {"count":12,"rate_bps":900,"label":"12 δόσεις (+9%)"}
]

Τα επιτόκια του παραδείγματος είναι ενδεικτικά. Μη έγκυρες γραμμές αγνοούνται. Αν καμία γραμμή δεν είναι έγκυρη, η αποθήκευση απορρίπτεται με το μήνυμα «Invalid rules. Nothing saved.»

Δοκιμή

Ενεργοποιήστε τα δοκιμαστικά στοιχεία της πύλης πληρωμών σας.
Προσθέστε προϊόν στο καλάθι και επιλέξτε την πύλη στο checkout.
Επιλέξτε πλάνο και ελέγξτε ότι εμφανίστηκε η γραμμή τόκου με το σωστό ποσό (π.χ. 3,00€ σε 100,00€ με 3%).
Δοκιμάστε με κουπόνι: ο τόκος πρέπει να υπολογίζεται στο ποσό μετά την έκπτωση.
Ολοκληρώστε δοκιμαστική πληρωμή και ελέγξτε ότι ο αριθμός δόσεων και το ποσό στην τράπεζα ταιριάζουν με την παραγγελία.
Επαναλάβετε σε κλασικό checkout και σε Checkout Block, αν χρησιμοποιείτε και τα δύο.

Go-live checklist

Τα πλάνα δεν ξεπερνούν τον μέγιστο αριθμό δόσεων που σας ενέκρινε η τράπεζα.
Οι ετικέτες είναι στα ελληνικά και δείχνουν καθαρά την επιβάρυνση.
Οι όροι χρήσης του e-shop αναφέρουν την επιβάρυνση των έντοκων δόσεων.
Η πύλη πληρωμών είναι σε live mode και υπάρχει στη λίστα Explicit gateway IDs.
Μία πραγματική συναλλαγή με δόσεις ελέγχθηκε από άκρη σε άκρη.

Αντιμετώπιση προβλημάτων

Σύμπτωμα	Πιθανή αιτία	Λύση
Δεν εμφανίζεται η επιλογή δόσεων στο checkout.	Το plugin είναι ανενεργό, η πύλη δεν είναι στη λίστα Explicit gateway IDs ή η πύλη δεν υποστηρίζει σύνδεση με το plugin.	Ενεργοποιήστε το Enabled, βάλτε το σωστό gateway ID και επιβεβαιώστε με την OBS ότι η πύλη σας υποστηρίζεται.
Ο τόκος δεν προστίθεται ή το σύνολο μένει το αρχικό.	Ο πελάτης έμεινε στο «Pay in full», άλλαξε πύλη πληρωμών, ή ενεργή παλαιότερη έκδοση συγκρούεται με τη νέα.	Ελέγξτε ότι επιλέγεται πλάνο, ότι η πύλη είναι η σωστή και ότι δεν είναι ενεργές ταυτόχρονα δύο εκδόσεις του plugin δόσεων.
Ο υπολογισμός δόσεων δεν λαμβάνει υπόψη το κουπόνι έκπτωσης.	Συμβαίνει σε παλαιότερες ροές όπου ο τόκος υπολογιζόταν στο υποσύνολο πριν την έκπτωση.	Στην έκδοση 1.0.0 ο τόκος υπολογίζεται στο ποσό μετά τις εκπτώσεις. Αναβαθμίστε και ελέγξτε με δοκιμαστικό κουπόνι.
Θέλετε διαφορετικές δόσεις ή επιτόκια ανά κατηγορία προϊόντων.	Η έκδοση 1.0.0 έχει ένα κοινό σύνολο κανόνων για όλο το κατάστημα.	Επικοινωνήστε με την OBS για προσαρμογή. Κανόνες ανά κατηγορία δεν περιλαμβάνονται στη βασική έκδοση.
Η τράπεζα άλλαξε περιβάλλον (π.χ. μετάβαση της Alpha Bank σε Nexi XPay) και οι δόσεις σταμάτησαν.	Η νέα πύλη πληρωμών έχει δικές της ρυθμίσεις δόσεων ή δεν υποστηρίζει ακόμη σύνδεση με το plugin.	Επικοινωνήστε με την OBS πριν τη μετάβαση. Ορισμένες νεότερες πύλες της OBS έχουν ενσωματωμένους κανόνες επιβάρυνσης δόσεων.
Η αποθήκευση των κανόνων αποτυγχάνει με «Invalid rules. Nothing saved.»	Το Rules JSON δεν είναι έγκυρο ή όλα τα πλάνα είναι εκτός ορίων (count 2–60, rate_bps 0–10000).	Διορθώστε τη σύνταξη JSON, π.χ. με εισαγωγικά και κόμματα, και τα όρια των τιμών.
Η παραγγελία απορρίπτεται στο checkout με μήνυμα για το πλάνο δόσεων.	Το καλάθι, η πύλη ή το ποσό τόκου άλλαξε μετά την επιλογή, ή η πύλη απέρριψε την προετοιμασία της συναλλαγής.	Ζητήστε από τον πελάτη να επιλέξει ξανά πλάνο και ελέγξτε τα WooCommerce logs και τη σημείωση της παραγγελίας.

← Πίσω στους οδηγούς