VibeFox Satispay for WooCommerce — Допомога

Вимоги

WordPress: 6.0 або новіша версія.

WooCommerce: 7.0 або новіша, встановлений і активний. Без нього плагін не активується.

PHP: 8.0 або новіша з розширенням OpenSSL. Без OpenSSL плагін показує помилку в адмін-панелі, а спосіб оплати не завантажується.

Валюта: EUR. Satispay приймає лише євро, тому спосіб оплати приховується, коли валюта магазину (або, на сторінці Pay for order, валюта замовлення) не EUR.

Обліковий запис Satispay: обліковий запис Satispay Business. API-ключі копіювати не потрібно: плагін підключається за одноразовим кодом активації, який ви створюєте в Satispay Business Dashboard (див. розділ Налаштування). Для тестів потрібен обліковий запис sandbox Satispay, який запитують у Satispay for developers.

Публічний сайт: ваш сайт має бути доступний з інтернету, щоб Satispay міг викликати його, коли змінюється платіж. У Satispay для цього нічого налаштовувати не потрібно.

Ліцензійний ключ VibeFox: купується на vibefox.net. Один ключ працює на одному домені.

Встановлення

1. У WordPress перейдіть до Plugins > Add New > Upload Plugin, виберіть ZIP-файл плагіна та натисніть Install Now. Також можна завантажити папку wcp_satispay_gateway до /wp-content/plugins/ через FTP.

2. Натисніть Activate.

3. Відкрийте налаштування: WooCommerce > Settings > Payments > Satispay > Manage або натисніть Settings під назвою плагіна на сторінці Plugins.

4. Введіть ліцензійний ключ VibeFox у блоці ліцензії у верхній частині сторінки та натисніть Activate.

5. Оберіть середовище: позначте Sandbox Mode для тестів, а для реальних платежів залиште позначку знятою.

6. Вставте код активації цього середовища в Activation Code і збережіть. Статус підключення покаже Key ID.

7. Увімкніть Enable/Disable і збережіть. Перевірте платіж у sandbox, потім зніміть позначку з Sandbox Mode і підключіть live-середовище кодом активації для live.

Налаштування

Усі налаштування розміщені на одній сторінці: WooCommerce > Settings > Payments > Satispay. Розділ Satispay connection показує стан обох середовищ, наприклад Live: Connected з Key ID або Sandbox: Not connected, і позначає середовище, яке використовується. Доки використовуване середовище не підключено, сторінка повідомляє: Satispay приховано на оформленні замовлення, доки використовуване середовище не буде підключено. У списку способів оплати WooCommerce Satispay позначено як такий, що потребує налаштування, доки використовуване середовище не підключено, а поки увімкнено Sandbox Mode, відображається позначка тестового режиму.

Enable/Disable: Enable Satispay payment вмикає або вимикає спосіб оплати. За замовчуванням: вимкнено.

Checkout

Що покупці бачать у списку способів оплати.

Title: назва способу оплати, яка відображається на оформленні замовлення. За замовчуванням: Satispay.

Description: текст під способом оплати на оформленні замовлення. За замовчуванням: Pay with the Satispay app: scan the QR code or confirm the payment on your phone.

Satispay connection

Sandbox Mode: Use the Satispay sandbox (staging) environment. Платежі в sandbox не списуються. За замовчуванням: вимкнено. Sandbox і live мають окремі ключі: підключайте кожне середовище кодом активації саме цього середовища. Поки використовується sandbox, покупці бачать під способом оплати напис Режим sandbox: реальні кошти не списуються.

Activation Code: щоб підключити середовище, обране вище, вставте новий 6-символьний код активації та збережіть. Коди для live створюються в Satispay Business Dashboard, у розділі Online shop. Коди sandbox отримують разом з обліковим записом sandbox Satispay. Код використовується один раз і не зберігається. Залиште поле порожнім, щоб зберегти поточне підключення.

Під час збереження з кодом плагін створює пару ключів RSA, надсилає відкритий ключ і код до Satispay та зберігає в базі даних WordPress Key ID і ключі цього середовища. У разі успіху сторінка показує, наприклад, Satispay Live connected. Key ID: і далі ідентифікатор. Якщо Satispay відхиляє код, сторінка показує повідомлення Satispay та просить перевірити, що код належить цьому середовищу і ще не використаний. Код із символами, відмінними від літер і цифр, відхиляється до будь-якого надсилання. Збереження нового коду для середовища замінює його попереднє підключення.

Payment notifications

У Satispay нічого налаштовувати не потрібно. Кожен платіж має власну callback URL, яку Satispay викликає при зміні платежу, а плагін перед зміною замовлення повторно перевіряє платіж через API Satispay. Розділ показує приклад цієї URL. Вона має такий вигляд: https://your-site/wc-api/satispay_payment_callback/?action=callback&order_id={order}&payment_id={uuid}. URL має бути доступна з інтернету: без режиму обслуговування та без захисту паролем для /wc-api/.

Advanced

Debug log: Log API calls and payment events записує в WooCommerce > Status > Logs, джерело wcp_satispay_gateway, без ключів і даних покупців. Помилки журналюються завжди, навіть коли цю опцію вимкнено. За замовчуванням: вимкнено.

Delete data on uninstall: Remove the settings and Satispay keys when the plugin is deleted. Платіжні дані, збережені в замовленнях, зберігаються. За замовчуванням: вимкнено.

Оформлення замовлення

Покупець вибирає спосіб оплати (за замовчуванням Satispay) і натискає Pay with Satispay. Плагін створює платіж Satispay на суму замовлення в євро з номером замовлення як посиланням і надсилає покупця на сторінку оплати Satispay. На комп'ютері покупець сканує QR-код застосунком Satispay. На телефоні покупець підтверджує платіж у застосунку.

Після оплати покупець повертається до вашого магазину. Замовлення позначається оплаченим лише після підтвердження Satispay: плагін отримує платіж через API Satispay, перевіряє, що його створено для цього замовлення, і порівнює його статус, суму (у центах) та валюту із замовленням. Це відбувається і коли Satispay викликає callback URL, і коли покупець повертається, — залежно від того, що станеться раніше. Якщо платіж ще не підтверджено, сторінка отримання замовлення показує: Satispay ще не підтвердив ваш платіж. Замовлення буде оновлено автоматично, щойно прийде підтвердження.

Якщо покупець залишає сторінку Satispay, не заплативши, плагін скасовує платіж у Satispay, тож покинуту сторінку більше не можна оплатити. Покупець повертається на оформлення замовлення (або на сторінку Pay for order) з повідомленням: Ваш платіж Satispay скасовано, і нічого не списано. Ви можете спробувати ще раз або обрати інший спосіб оплати. Те саме повідомлення з'являється, якщо покупець відхиляє платіж у застосунку.

Покупець може знову оплатити неоплачене замовлення, наприклад зі сторінки Pay for order. Перед створенням нового платежу Satispay попередній перевіряється: незавершений платіж скасовується в Satispay, а якщо його вже оплачено, замовлення позначається оплаченим цим платежем і другий платіж не створюється.

Якщо платіж не вдалося почати, покупець бачить коротке повідомлення і може обрати інший спосіб оплати: Satispay наразі недоступний. Будь ласка, оберіть інший спосіб оплати. — коли магазин не підключено або Satispay відхиляє ключі, або Не вдалося створити платіж Satispay. Будь ласка, спробуйте ще раз або оберіть інший спосіб оплати. — для інших помилок. Причина записується в журнал.

Спосіб оплати працює на класичному оформленні замовлення, у блоці Checkout і на сторінці Pay for order. Він сумісний із WooCommerce High-Performance Order Storage (HPOS).

Плагін приймає лише разові платежі в євро. Він не підтримує підписки, збережені способи оплати, попередні авторизації та талони на харчування. Планової перевірки незавершених платежів немає: якщо ані callback Satispay, ані повернення покупця не досягають вашого сайту, замовлення залишається в статусі Pending payment, а платіж видно в Satispay Dashboard.

Замовлення та повернення коштів

Order statuses

Pending payment: покупця відправлено до Satispay, і він ще не оплатив, або Satispay ще не підтвердив платіж. У примітці до замовлення показано ID платежу Satispay, суму та середовище (Live або Sandbox).

Processing or Completed: платіж підтверджено. Замовлення відповідає стандартному правилу WooCommerce: Обробляється, або Виконано для замовлень лише з віртуальними товарами для завантаження. У примітці до замовлення показано платіж Satispay, суму та спосіб перевірки (callback, перенаправлення або оформлення замовлення). ID транзакції — це ID платежу Satispay.

On hold: Satispay повідомив суму або валюту, що відрізняються від суми замовлення, або платіж було прийнято після скасування замовлення. Примітка до замовлення це пояснює, а платіж зберігається як ID транзакції, щоб його можна було повернути. Перевірте платіж у Satispay Dashboard, потім завершіть замовлення або поверніть платіж.

Cancelled: останній платіж Satispay за замовленням скасовано або прострочено, наприклад тому, що покупець залишив сторінку Satispay. Старіший платіж, що прострочується, не скасовує замовлення з новішим платежем, який виконується. Замовлення, створені вами в адмін-панелі (платіжні посилання), не скасовуються: вони залишаються в статусі Pending payment з приміткою, щоб покупець міг їх оплатити.

Якщо для вже оплаченого замовлення приймається другий платіж, замовлення не змінюється. Примітка просить вас повернути дубльований платіж через Satispay Dashboard. Повторне підтвердження ніколи не відкриває знову скасоване або повернене замовлення.

Refunds

Відкрийте замовлення, натисніть Refund, введіть суму та натисніть Refund via Satispay. Повні та часткові повернення підтримуються для замовлень, оплачених через Satispay. Повернення надсилається в середовище, в якому було зроблено платіж (live або sandbox), тож це середовище має залишатися підключеним. Повернення вважається виконаним лише тоді, коли Satispay його приймає: успішне повернення додається до приміток замовлення з ID повернення Satispay та причиною. Якщо Satispay не приймає повернення, WooCommerce показує помилку, і повернення не фіксується.

Повернення, зроблені в Satispay Dashboard, не перетворюються на повернення WooCommerce. За потреби створіть ручне повернення в WooCommerce без використання Refund via Satispay.

Ліцензійний ключ

Плагін працює з ліцензійним ключем VibeFox з vibefox.net. Блок ліцензії розміщено у верхній частині сторінки WooCommerce > Settings > Payments > Satispay. Вставте ключ у поле License key і натисніть Activate. Блок показує статус, наприклад дату, до якої ліцензія активна, і ваш домен. Скористайтеся Check now, щоб перевірити статус ще раз, Change key, щоб ввести інший ключ, і Remove key, щоб видалити його з цього сайту. Посилання Manage licenses and domains in your account відкриває ваш обліковий запис vibefox.net.

Один ключ працює на одному домені. Видалення ключа з сайту не звільняє місце для домену. Звільніть його у своєму обліковому записі vibefox.net.

Без активного ключа Satispay не показується покупцям на оформленні замовлення. Якщо платіж все ж почато, покупець бачить Цей спосіб оплати недоступний. Оберіть інший. Менеджери магазину, які ввійшли в систему, і далі бачать спосіб оплати, позначений як (unlicensed — visible to admins only), щоб ви могли налаштувати і протестувати плагін до купівлі ключа. Нагадування з'являється на сторінці Plugins і на сторінках WooCommerce. Наявні замовлення не зачіпаються: вже розпочаті платежі й далі підтверджуються, а повернення працюють.

Коли ліцензія закінчується, плагін продовжує працювати, але для оновлень і підтримки потрібне продовження. Статус автоматично перевіряється знову у фоновому режимі.

Усунення несправностей

Satispay не з'являється на оформленні замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено, використовуване середовище підключено (розділ Satispay connection показує для нього Connected) і валюта EUR.

Платіж пройшов, але замовлення залишається в статусі Pending payment: замовлення оновлюється, коли Satispay викликає ваш сайт або коли покупець повертається. Перевірте, що ваш сайт доступний з інтернету, без режиму обслуговування та без захисту паролем для /wc-api/, і перегляньте WooCommerce > Status > Logs, джерело wcp_satispay_gateway. Платіж видно в Satispay Dashboard.

Callback відповідає Payment status unavailable, retry later або Not configured: плагін не зміг отримати платіж від Satispay, або середовище замовлення не підключено. Замовлення не змінюється. Перевірте стан підключення та журнал.

Callback відповідає Busy, retry later: замовлення в цей момент оновлював інший запит. Цей callback замовлення не змінює. Воно буде оновлено наступним callback або коли покупець повернеться.

Callback відповідає Unknown payment або Missing or invalid payment_id: платіж не створювався для цього замовлення, або запит не є callback від Satispay. Замовлення не змінюється.

Активація не вдалася: коди активації можна використати лише один раз. Перевірте, що код належить до середовища, обраного в Sandbox Mode (live-код для live, sandbox-код для sandbox), згенеруйте новий код і збережіть знову. Якщо сторінка повідомляє, що не вдалося створити пару ключів RSA, попросіть хостинг увімкнути розширення PHP OpenSSL.

Satispay зник з оформлення замовлення після переходу з sandbox на live: sandbox і live використовують різні ключі. Вставте live-код активації з вимкненим Sandbox Mode і збережіть.

Замовлення має статус On hold, і примітка не відповідає замовленню: Satispay повідомив суму або валюту, що відрізняються від суми замовлення, наприклад тому, що замовлення було змінено після початку платежу. Перевірте платіж у Satispay Dashboard, потім завершіть замовлення або поверніть платіж.

Повернення не вдається, бо середовище більше не підключено: платіж було зроблено в live або sandbox, а в цього середовища більше немає ключів. Підключіть його знову кодом активації або поверніть платіж через Satispay Dashboard.

Повернення не вдається з повідомленням Satispay did not accept the refund: Satispay повернув статус, відмінний від accepted. WooCommerce не зафіксував повернення. Перевірте його в Satispay Dashboard.

Блок ліцензії показує помилку: дотримуйтеся повідомлення в блоці. Наприклад, якщо ключ уже використовується на іншому домені, звільніть місце у своєму обліковому записі vibefox.net і натисніть Check now. Якщо адреса сайту змінилася, натисніть Check now, щоб активувати ключ для нового домену. Якщо сервер ліцензій недоступний, плагін працює з останнім відомим статусом.

Видалення

Деактивація плагіна зберігає всі дані. Щоб видалити його, деактивуйте і видаліть на сторінці Plugins. Ліцензійний ключ і статус ліцензії цього плагіна завжди видаляються. Налаштування шлюзу, ключі Satispay обох середовищ і журнали плагіна видаляються, лише якщо була увімкнена опція Delete data on uninstall. Інакше вони зберігаються для майбутнього повторного встановлення. Наявні замовлення зберігають свої платіжні примітки та ID транзакцій.

Satispay є торговою маркою її власника. Цей плагін не пов'язаний із Satispay і не схвалений нею.