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

Вимоги

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

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

PHP: 8.0 або новіша версія.

Валюта та суми: євро (EUR), від 0,99 до 20 000,00 за платіж — стандартні значення PayPlug. За іншої валюти або поза цими межами спосіб оплати приховується.

Обліковий запис PayPlug: потрібні секретні ключі вашого облікового запису PayPlug: тестовий ключ (sk_test_...) та/або робочий ключ (sk_live_...). Жодних інших ключів не потрібно, і в PayPlug не треба налаштовувати сповіщення. Ваш сайт має бути доступним з інтернету, щоб отримувати сповіщення; інакше замовлення оновлюються, коли покупець повертається з PayPlug.

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

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

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

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

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

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

5. Вставте секретні ключі з порталу PayPlug (див. розділ «Налаштування»).

6. Увімкніть Enable/Disable і збережіть. Перевірте платіж з увімкненим Test Mode, потім вимкніть його, щоб приймати реальні платежі.

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

Усі параметри розміщені на одній сторінці: WooCommerce > Settings > Payments > PayPlug. Над полями сторінка попереджає, коли спосіб оплати увімкнено, але секретний ключ поточного режиму порожній, а також коли валюта магазину не EUR. В обох випадках спосіб оплати приховується на оформленні замовлення. У списку способів оплати PayPlug у тестовому режимі показує позначку тестового режиму і позначається як такий, що потребує налаштування, доки для поточного режиму не вказано секретний ключ.

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

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

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

Description: текст під способом оплати на оформленні замовлення. За замовчуванням: Pay securely by card via PayPlug.

API-ключі

Секретні ключі знаходяться у порталі PayPlug у розділі Developers > API keys. Там же відображається URL для сповіщень, який плагін передає з кожним платежем. Він має такий вигляд: https://your-site/wc-api/ppg_payplug_webhook/. У PayPlug налаштовувати сповіщення не потрібно.

Test Mode: Enable test mode використовує тестовий секретний ключ для нових платежів. Реальні платежі не обробляються. Платежі, створені в іншому режимі, для перевірки статусу та повернень і далі використовують ключ свого режиму. За замовчуванням: on.

Test Secret Key: ваш тестовий секретний ключ PayPlug. Він починається з sk_test_.

Live Secret Key: ваш робочий секретний ключ PayPlug. Він починається з sk_live_.

Ключ із неправильним префіксом не зберігається. Сторінка показує, наприклад, Test Secret Key має починатися з «sk_test_». Попереднє значення збережено.

Замовлення

Order Status After Payment: статус замовлення, який встановлюється після успішної оплати. Статус встановлюється одразу, без другої зміни статусу.

Додатково

Logging: Enable debug logging записує виклики API та сповіщення в WooCommerce > Status > Logs, джерело wcp_payplug_gateway. Помилки записуються завжди. Секретні ключі, дані картки та дані покупця ніколи не записуються. За замовчуванням: off.

Delete Data on Uninstall: Remove all plugin data when uninstalling. Якщо позначено, під час видалення плагіна видаляються його налаштування та журнали. Ідентифікатори платежів PayPlug, збережені в замовленнях, зберігаються. За замовчуванням: off.

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

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

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

Якщо покупець скасовує оплату на сторінці PayPlug, сторінка оплати закривається в PayPlug, тож її не можна випадково оплатити пізніше. Покупець повертається на сторінку Pay for order з повідомленням, наприклад Ви скасували платіж PayPlug. Можете спробувати ще раз або обрати інший спосіб оплати., Сеанс оплати PayPlug завершився. Спробуйте ще раз або оберіть інший спосіб оплати. або Платіж PayPlug не вдався. Спробуйте ще раз або оберіть інший спосіб оплати.

Коли покупець оплачує те саме замовлення повторно, плагін спочатку перевіряє попередню спробу. Якщо її тим часом оплатили, замовлення завершується без нового платежу. Якщо вона ще відкрита на ту саму суму, використовується та сама сторінка оплати. Інакше стара сторінка закривається в PayPlug, і створюється новий платіж.

Якщо PayPlug не може розпочати платіж, покупець бачить коротке повідомлення, наприклад PayPlug не зміг прийняти ваші платіжні дані (поштовий індекс). Перевірте їх і спробуйте ще раз. або Не вдалося зв'язатися з платіжним провайдером. Спробуйте ще раз за мить. Технічна причина додається до приміток замовлення.

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

Платежі списуються одразу. Плагін не підтримує розстрочку Oney, Bancontact, Apple Pay чи American Express, збережені картки для оплати в один клік, вбудовану форму оплати, підписки та відкладене списання.

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

Order statuses

Pending payment: покупця перенаправлено до PayPlug, і він ще не оплатив, або PayPlug ще не підтвердив платіж.

Processing or Completed: платіж підтверджено. Статус відповідає Order Status After Payment. У примітці до замовлення вказано платіж PayPlug та його режим. Ідентифікатор транзакції — це ідентифікатор платежу PayPlug (pay_...).

On hold: оплачена сума або валюта не збігаються із замовленням (примітка amount/currency mismatch); або тестовий платіж був здійснений, поки магазин працює в робочому режимі, тож гроші не надійшли; або платіж надійшов для замовлення, яке вже скасували; або платіж авторизовано, але не списано (списати його можна в порталі PayPlug; замовлення позначиться оплаченим, коли PayPlug повідомить про оплату). Примітка до замовлення пояснює, що перевірити.

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

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

Повернення коштів

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

Повернення, зроблені в порталі PayPlug, надходять через сповіщення і додаються до приміток замовлення. У WooCommerce вони не створюються автоматично. За потреби внесіть їх вручну.

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

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

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

Без активного ключа PayPlug не показується покупцям на оформленні замовлення. Якщо платіж все одно розпочато, покупець бачить This payment method is not available. Please choose another one. Адміністратори магазину, які ввійшли в систему, усе ще бачать спосіб оплати з позначкою (unlicensed — visible to admins only), щоб можна було налаштувати та протестувати плагін до покупки ключа. Нагадування з'являється на сторінці Plugins і на сторінках WooCommerce. Існуючі замовлення не зачіпаються: уже розпочаті платежі й надалі підтверджуються, а повернення працюють.

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

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

PayPlug не з'являється на оформленні замовлення: перевірте, що ліцензія активна, увімкнено Enable/Disable, у поточному режимі є секретний ключ (Test Secret Key у тестовому режимі, Live Secret Key у робочому), валюта магазину — EUR, а сума замовлення між 0,99 і 20 000,00 EUR. Облікові записи з іншими лімітами можуть змінити їх фільтром ppg_amount_limits (значення в копійках).

Платіж пройшов, але замовлення залишається в статусі «Очікує оплати»: сповіщення не дійшло до вашого магазину, а покупець не повернувся. Перевірте, чи доступний ваш сайт з інтернету за URL сповіщень, який показано в налаштуваннях, наприклад чи не блокує його режим обслуговування, брандмауер або захист паролем. Перегляньте WooCommerce > Status > Logs, джерело wcp_payplug_gateway, щоб знайти відхилені сповіщення.

Сповіщення відповідає Verification failed: платіж не вдалося зчитати з API PayPlug, наприклад тому що PayPlug не відповів. Замовлення не змінюється, і PayPlug надішле сповіщення повторно.

Сповіщення відповідає Busy, retry: замовлення саме оновлював інший запит, наприклад повернення покупця. PayPlug надішле сповіщення повторно.

Сповіщення відповідає Unknown payment або Payment does not belong to the order: платіж створено не цим магазином або не для цього замовлення, наприклад платіж іншого магазину на тому самому обліковому записі PayPlug. Його ігнорують.

Покупець бачить Payment could not be initiated: попередня спроба оплати цього замовлення зараз підтверджується, або PayPlug відхилив запит. Зачекайте мить і спробуйте знову; у примітках до замовлення показано помилку PayPlug.

Замовлення на утриманні після оплати: прочитайте примітку до замовлення. Оплачена сума або валюта не збіглися із замовленням, тестовий платіж було здійснено в робочому режимі, або платіж надійшов після скасування замовлення. Обробіть замовлення або поверніть платіж.

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

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

Видалення

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

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