Οδηγός Viva Payments για WooCommerce

Payment Source, redirect URLs, Demo/Live environment, credentials, timeout και δόσεις για Viva Payments στο WooCommerce.

Εγκατάσταση και ρύθμιση του Viva Payments για WooCommerce

Ο οδηγός αφορά την έκδοση 2.0.2 του plugin της OBS. Η OBS κάνει δωρεάν την εγκατάσταση. Χρειάζεται μόνο να έχετε έτοιμα τα στοιχεία από τη Viva.

Προαπαιτούμενα από τη Viva

Ενεργός επιχειρηματικός λογαριασμός Viva.com με δυνατότητα online πληρωμών (και demo λογαριασμός για δοκιμές).
Merchant ID και API Key του λογαριασμού.
Payment Source για το domain σας (Sales → Payment Sources) με:
- Integration method: Redirection
- Success URL: https://το-site-σας/wc-api/WC_Gateway_Viva/
- Failure URL: https://το-site-σας/wc-api/WC_Gateway_Viva/?status=fail
Τα ακριβή URLs τα βλέπετε στην κορυφή της σελίδας ρυθμίσεων του plugin.
Ο Source Code του Payment Source.
Ενεργό SSL (https) στο e-shop.

Εγκατάσταση και License key

Κατεβάστε το ZIP από τον λογαριασμό σας στην OBS.
WordPress → Plugins → Add New → Upload Plugin → Install Now → Activate.
Ενεργοποιήστε το License key σύμφωνα με τον οδηγό Ενεργοποίηση άδειας. Η άδεια αφορά ένα domain.
Πηγαίνετε WooCommerce → Ρυθμίσεις → Πληρωμές → Viva Payments.

Χάρτης ρυθμίσεων

Πεδίο	Τι κάνει	Προεπιλογή
Enable/Disable (Enable Viva Payments)	Ενεργοποιεί τη μέθοδο στο checkout.	Ενεργό
Title	Όνομα της μεθόδου που βλέπει ο πελάτης.	Viva Payments
Description	Κείμενο κάτω από τη μέθοδο στο checkout.	Κενό
Viva Payments Host	Demo (`demo.vivapayments.com`) για δοκιμές ή Live (`www.vivapayments.com`) για πραγματικές πληρωμές.	Demo
Viva Merchant ID	Το Merchant ID του λογαριασμού Viva (του αντίστοιχου περιβάλλοντος).	—
Viva API Key	Το API Key του λογαριασμού Viva (του αντίστοιχου περιβάλλοντος).	—
Source Code	Ο κωδικός του Payment Source που δημιουργήσατε για το site.	Default
Payment Timeout, secs	Πόσα δευτερόλεπτα ισχύει η πληρωμή στη σελίδα της Viva.	300
Max Installments (1–36)	Πίνακας κανόνων Min Total / Max Total / Max Installments. Για καλάθι πάνω από το Min και έως το Max Total επιτρέπονται έως τόσες δόσεις.	Χωρίς δόσεις

Δοκιμή (Demo)

Επιλέξτε Viva Payments Host = Demo και περάστε τα demo Merchant ID, API Key και Source Code.
Κάντε δοκιμαστική παραγγελία με δοκιμαστική κάρτα της Viva.
Ελέγξτε ότι επιστρέψατε στη σελίδα ευχαριστίας, ότι η παραγγελία πήγε σε «Επεξεργασία» και ότι αποθηκεύτηκε transaction ID.
Δοκιμάστε και ακύρωση πληρωμής: πρέπει να επιστρέψετε στο checkout με μήνυμα σφάλματος.
Αν έχετε δόσεις, ελέγξτε ότι εμφανίζεται ο «Αριθμός Δόσεων» στα σωστά ποσά.

Go-live checklist

Viva Payments Host = Live, με τα Live Merchant ID, API Key και Source Code.
Το Live Payment Source έχει τα σωστά Success / Failure URLs του domain σας.
Η διεύθυνση /wc-api/WC_Gateway_Viva/ εξαιρείται από cache, firewall και plugins ασφαλείας.
Μία πραγματική πληρωμή μικρού ποσού ολοκληρώθηκε και η παραγγελία ενημερώθηκε.
Η ομάδα σας ξέρει ότι οι επιστροφές χρημάτων γίνονται από τη Viva.

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

Σύμπτωμα	Πιθανή αιτία	Λύση
Ο πελάτης χρεώθηκε αλλά η παραγγελία έμεινε «Σε αναμονή πληρωμής».	Το plugin επιβεβαιώνει την πληρωμή όταν ο πελάτης επιστρέφει στο Success URL. Αν τα URLs του Payment Source είναι λάθος (π.χ. μετά από αλλαγή domain, https ή μεταφορά site), αν το /wc-api/ μπλοκάρεται από cache ή firewall, ή αν ο πελάτης κλείσει τον browser πριν επιστρέψει, η παραγγελία δεν ενημερώνεται.	Ελέγξτε τα Success/Failure URLs στη Viva, εξαιρέστε το /wc-api/WC_Gateway_Viva/ από cache και firewall, επιβεβαιώστε τη συναλλαγή στη Viva και ενημερώστε χειροκίνητα την παραγγελία.
Εμφανίζεται «Viva error: no order code received» στο checkout.	Η Viva δεν δημιούργησε payment order: λάθος Merchant ID ή API Key, demo στοιχεία με Live host (ή αντίστροφα), ή λάθος Source Code.	Ελέγξτε ότι Host, Merchant ID, API Key και Source Code ανήκουν στο ίδιο περιβάλλον (Demo ή Live) και ότι το Payment Source είναι ενεργό.
Οι πληρωμές αποτυγχάνουν μετά τη δημιουργία στοιχείων Smart Checkout στη Viva.	Δημιουργήθηκαν Client ID / Client Secret (OAuth), που δεν χρησιμοποιούνται από το plugin.	Χρησιμοποιήστε Merchant ID και API Key και δημιουργήστε Payment Source με Integration method Redirection.
Η πληρωμή στη Viva πέτυχε αλλά η παραγγελία εμφανίζεται ακυρωμένη ή αποτυχημένη.	Η επιστροφή έγινε στο Failure URL ή άλλο plugin/αυτοματισμός άλλαξε το status (π.χ. ακύρωση απλήρωτων παραγγελιών λόγω χρονικού ορίου αποθέματος).	Ελέγξτε τη σημείωση παραγγελίας και τη συναλλαγή στη Viva, αυξήστε το «Κράτηση αποθέματος» του WooCommerce αν χρειάζεται και ελέγξτε τα URLs του Payment Source.
Η περιγραφή της μεθόδου δεν εμφανίζεται στο checkout.	Στα Checkout Blocks, όταν έχουν οριστεί δόσεις, εμφανίζεται η επιλογή δόσεων στη θέση της περιγραφής.	Συμπεριλάβετε το σημαντικό μήνυμα στο Title ή αφήστε κενό τον πίνακα δόσεων αν δεν τις χρειάζεστε.
Δεν μπορείτε να κάνετε επιστροφή χρημάτων από την παραγγελία.	Το plugin δεν υποστηρίζει refunds μέσω WooCommerce.	Κάντε την επιστροφή από το περιβάλλον της Viva και καταγράψτε τη χειροκίνητα στην παραγγελία.
Μετά από αντιγραφή (clone) του site σε άλλο domain οι πληρωμές δεν ολοκληρώνονται.	Το Payment Source και η άδεια αντιστοιχούν στο αρχικό domain.	Δημιουργήστε Payment Source με τα URLs του νέου domain και ζητήστε από την OBS άδεια ή αλλαγή domain.

Βήματα εγκατάστασης

Βήμα 1

Payment Source

Δημιουργούμε ή επιβεβαιώνουμε τη Viva Payment Source για το συγκεκριμένο eshop.
Βήμα 2

Gateway settings

Ορίζουμε environment, Merchant ID, API Key, Source Code και timeout.
Βήμα 3

Redirect URLs

Περνάμε τα success/failure URLs που εμφανίζει το WooCommerce plugin.
Βήμα 4

Sandbox QA

Δοκιμάζουμε success, failure, cancel και browser-close σενάρια.
Βήμα 5

Go-live

Περνάμε τα live στοιχεία μόνο μετά την έγκριση και κάνουμε ελεγχόμενη συναλλαγή.

Συχνές ερωτήσεις

Πού βρίσκω Merchant ID, API Key και Source Code;

Στο εγκεκριμένο Viva merchant account και στη Payment Source που αντιστοιχεί στο συγκεκριμένο eshop.

Χρησιμοποιώ τα ίδια callback URLs σε κάθε eshop;

Όχι. Κάθε eshop χρησιμοποιεί τα URLs που εμφανίζει η δική του εγκατάσταση.

Τι τιμή βάζω στο timeout;

Η τιμή επιβεβαιώνεται με τη ροή του merchant και το unpaid-order policy του WooCommerce. Δεν αλλάζει χωρίς sandbox test.

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