VibeFox Paysera for WooCommerce — Допомога
Вимоги
WordPress: 6.0 або новіший.
WooCommerce: 7.0 або новіший, встановлений і активний. Без нього плагін не активується.
PHP: 8.0 або новіший.
Проєкт Paysera: потрібні ідентифікатор проєкту та пароль проєкту (ключ підпису) вашого проєкту Paysera. Способи оплати, які бачить покупець, — це способи, увімкнені в цьому проєкті. У Paysera для callback-повідомлення нічого налаштовувати не потрібно: його URL передається з кожним запитом на оплату.
Доступний сайт: замовлення оплачуються через callback-повідомлення Paysera, тож ваш сайт має бути доступним з інтернету, а не розташовуватися за логіном, режимом обслуговування чи файрволом.
Ліцензійний ключ VibeFox: купується на vibefox.net. Один ключ працює на одному домені.
Встановлення
1. У WordPress перейдіть до Plugins > Add New > Upload Plugin, оберіть ZIP-файл плагіна та натисніть Install Now. Також можна завантажити папку wcp_paysera_payment до /wp-content/plugins/ через FTP.
2. Натисніть Activate.
3. Відкрийте налаштування: WooCommerce > Settings > Payments > Paysera > Manage або натисніть Settings під назвою плагіна на сторінці «Плагіни».
4. Введіть ліцензійний ключ VibeFox у блоку ліцензії вгорі сторінки та натисніть Activate.
5. Введіть Project ID та Project password з вашого облікового запису Paysera (див. розділ «Налаштування»).
6. За бажанням: увімкніть Allow test payments у проєкті Paysera та Test payments у плагіні, щоб перевірити процес без списання коштів. Вимкніть їх перед початком продажів.
7. Увімкніть Enable/Disable і збережіть.
Налаштування
Усі налаштування розміщені на одній сторінці: WooCommerce > Settings > Payments > Paysera. Над полями сторінка показує Paysera приховано на оформленні замовлення, доки не введено Project ID та Project password., поки одне з них не заповнене, а також попередження, що покупців не списують кошти, поки ввімкнено тестові платежі або пісочницю. У списку способів оплати Paysera позначається як такий, що потребує налаштування, доки проєкт не налаштовано, а за ввімкнених тестових платежів або пісочниці відображається позначка тестового режиму.
Загальні
Enable/Disable: Enable Paysera Payment вмикає або вимикає спосіб оплати. За замовчуванням: вимкнено.
Title: назва способу оплати, яку бачить покупець на оформленні замовлення. За замовчуванням: Paysera.
Description: текст під способом оплати на оформленні замовлення. За замовчуванням: Pay securely via Paysera.
Проєкт Paysera
Project ID та Project password знаходяться у вашому обліковому записі Paysera в розділі Projects and activities: оберіть свій проєкт, потім General project settings. У цьому розділі вказано URL callback-повідомлення, який має такий вигляд: https://your-site/wc-api/wc_psr_payment/. Він передається автоматично з кожним платежем; у Paysera нічого налаштовувати не потрібно.
Project ID: числовий ідентифікатор вашого проєкту Paysera.
Project password: пароль проєкту (ключ підпису). Ним підписуються запити на оплату і перевіряються callback-повідомлення Paysera.
Тестування
Test payments: Send payments in test mode (no money is charged). Paysera повертає успішний тестовий платіж без списання коштів з покупця. Спочатку увімкніть Allow test payments у налаштуваннях проєкту Paysera. Поки ця опція увімкнена, тестові платежі позначають замовлення як оплачені; коли вона вимкнена, тестовий платіж ніколи не оплачує замовлення. За замовчуванням: вимкнено.
Environment: куди надсилається покупець. Для звичайного проєкту Paysera залиште Production, зокрема для тестових платежів. За замовчуванням: Production.
Додатково
Debug log: Log payment events. Помилки записуються завжди. Журнали розташовані в WooCommerce > Status > Logs, джерело wcp_paysera_payment. Паролі та дані покупців ніколи не записуються. За замовчуванням: вимкнено.
Delete data: Delete the plugin settings and logs when the plugin is deleted. Деактивація плагіна нічого не видаляє. Дані замовлень завжди зберігаються. За замовчуванням: вимкнено.
Оформлення замовлення
Покупець обирає спосіб оплати (за замовчуванням Paysera) і оформлює замовлення. Коли тестові платежі увімкнено, на оформленні замовлення відображається ТЕСТОВИЙ РЕЖИМ — кошти не будуть списані. Плагін формує підписаний запит на оплату із сумою замовлення в мінімальних одиницях валюти замовлення, іменем, адресою електронної пошти та платіжною адресою покупця, а також мовою, вибраною відповідно до мови вашого сайту (литовська, латвійська, естонська, російська, німецька, польська, інакше англійська). Покупець переходить у платіжне вікно Paysera і обирає там банк, картку або інший спосіб.
Після оплати покупець повертається на сторінку отриманого замовлення. Замовлення позначається як оплачене лише тоді, коли надійде підписане callback-повідомлення Paysera; саме повернення ніколи не оплачує замовлення.
Якщо покупець скасовує оплату у вікні Paysera, замовлення скасовується стандартним для WooCommerce способом, і покупець може оформити замовлення знову. Якщо платіж не вдалося розпочати, покупець бачить повідомлення Платежі Paysera тимчасово недоступні. Оберіть інший спосіб оплати. Причина записується в журнал.
Спосіб оплати працює на класичному оформленні замовлення, у блоку «Оформлення замовлення» та на сторінці Pay for order. Він сумісний із WooCommerce High-Performance Order Storage (HPOS).
Плагін не підтримує повернення коштів через WooCommerce, не пропонує вибір банку чи способу оплати на оформленні замовлення, а також не підтримує підписки, збережені картки та кур’єрські або доставні служби Paysera.
Замовлення
Статуси замовлення
Pending payment: покупця перенаправлено на Paysera, а callback-повідомлення ще не надійшло.
Processing: Paysera підтвердив платіж (статус 1). Замовлення, що містять лише віртуальні товари для завантаження, переходять у статус «Виконано» — значення WooCommerce за замовчуванням. У примітці до замовлення вказано запит Paysera та спосіб оплати. Ідентифікатор транзакції — це ідентифікатор запиту Paysera.
On hold: Paysera прийняв платіжне доручення, але ще не виконав його (статус 2), і замовлення буде завершено, коли Paysera підтвердить платіж; або сплачені сума чи валюта не збігаються із замовленням (примітка amount/currency mismatch); або отримано ТЕСТОВИЙ платіж, коли тестові платежі були вимкнені, тому кошти не списано. Примітка до замовлення пояснює причину.
Cancelled: покупець скасував оплату у вікні Paysera, або замовлення скасували ви чи спливло обмеження часу резервування товару. Платіж, підтверджений згодом для скасованого замовлення, не змінює його статус: примітка пропонує відновити замовлення (перевести в статус «В обробці») або повернути платіж у Paysera.
Інші статуси Paysera (платіж не виконано, додаткова інформація) лише додають примітку. Якщо для вже оплаченого замовлення надходить ще один успішний платіж, замовлення не змінюється, а примітка пропонує повернути дублікат у вашому обліковому записі Paysera.
Повернення коштів
Повернення коштів через WooCommerce не підтримуються: протокол платіжного вікна Paysera не має API для повернень. Оформлюйте повернення у вашому обліковому записі Paysera. Коли Paysera повідомляє про повернення, до замовлення додається примітка із сумою повернення, а статус замовлення не змінюється. За потреби зафіксуйте повернення в WooCommerce вручну.
Ліцензійний ключ
Плагін працює з ліцензійним ключем VibeFox із сайту vibefox.net. Блок ліцензії розташований угорі сторінки WooCommerce > Settings > Payments > Paysera. Вставте ключ у поле License key і натисніть Activate. Блок показує статус, наприклад дату, до якої ліцензія активна, та ваш домен. Кнопкою Check now можна повторно перевірити статус, Change key дозволяє ввести інший ключ, а Remove key видаляє його з цього сайту. Посилання Manage licenses and domains in your account відкриває ваш обліковий запис vibefox.net.
Один ключ працює на одному домені. Видалення ключа з сайту не звільняє місце під домен. Звільніть його у своєму обліковому записі vibefox.net.
Без чинного ключа Paysera не відображається покупцям на оформленні замовлення. Якщо платіж усе ж розпочато, покупець бачить повідомлення This payment method is not available. Please choose another one. Авторизовані адміністратори магазину й надалі бачать спосіб оплати, позначений (unlicensed — visible to admins only), щоб ви могли налаштувати й перевірити плагін до купівлі ключа. Нагадування з’являється на сторінці «Плагіни» та на сторінках WooCommerce. Наявні замовлення не змінюються: платежі, які вже розпочато, і далі підтверджуються.
Коли строк дії ліцензії спливає, плагін продовжує працювати, але для оновлень і підтримки потрібне продовження. Статус автоматично перевіряється у фоновому режимі.
Усунення несправностей
Paysera не з’являється на оформленні замовлення: перевірте, що ліцензія активна, що Enable/Disable увімкнено та заповнено Project ID і Project password. Сторінка налаштувань показує попередження, поки одне з полів порожнє.
Платіж пройшов, але замовлення залишається у статусі Pending payment: замовлення оплачується callback-повідомленням Paysera, а не поверненням покупця. Перевірте, що ваш сайт доступний з інтернету за URL callback-повідомлення, вказаним у налаштуваннях (не за логіном, режимом обслуговування чи файрволом), і подивіться WooCommerce > Status > Logs, джерело wcp_paysera_payment.
Callback відповідає Invalid signature: Project password не відповідає проєкту, або callback-повідомлення надійшло не від Paysera. Скопіюйте пароль проєкту знову.
Callback відповідає Project ID mismatch: Project ID у налаштуваннях відрізняється від проєкту, який здійснив платіж.
Callback відповідає Gateway not configured або Busy: ідентифікатор або пароль проєкту порожній, або для того самого замовлення ще виконується інший callback. Paysera повторює callback-повідомлення.
Paysera відхиляє платіжне вікно або повідомляє, що проєкту не існує: перевірте Environment. Звичайний проєкт Paysera працює лише з Production; для Sandbox потрібен проєкт, створений у пісочниці Paysera.
Тестовий платіж не оплачує замовлення: ТЕСТОВИЙ платіж оплачує замовлення лише за увімкненої опції Test payments. Інакше замовлення переходить у статус «На утриманні» з приміткою, що кошти не списано. Також увімкніть Allow test payments у проєкті Paysera.
На оформленні замовлення немає іконки: плагін за замовчуванням не показує іконку. Розробники можуть задати її фільтром wc_psr_gateway_icon.
Замовлення має статус On hold із приміткою про невідповідність суми або валюти: Paysera підтвердив платіж, сума або валюта якого не збігається із сумою замовлення, наприклад тому, що замовлення було змінено після того, як покупець почав оплату. Звірте платіж у своєму обліковому записі Paysera і завершіть або поверніть замовлення вручну.
Блок ліцензії показує помилку: дотримуйтеся повідомлення в блоці. Наприклад, якщо ключ уже використовується на іншому домені, звільніть місце у вашому обліковому записі vibefox.net і натисніть Check now. Якщо адреса сайту змінилася, натисніть Check now, щоб активувати ключ для нового домену. Якщо сервер ліцензій недоступний, плагін продовжує працювати за останнім відомим статусом.
Видалення
Деактивація плагіна зберігає всі дані. Щоб видалити його, деактивуйте та видаліть плагін на сторінці Plugins. Ліцензійний ключ і статус ліцензії цього плагіна видаляються завжди. Налаштування платіжного шлюзу та журнали видаляються лише тоді, коли була увімкнена опція Delete data. Інакше вони зберігаються для повторного встановлення. Наявні замовлення зберігають свої примітки про оплату та ідентифікатори транзакцій.
Paysera є товарним знаком відповідного власника. Цей плагін не пов’язаний із Paysera і не схвалений нею.