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

Вимоги

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

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

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

Валюта: GoPay приймає CZK, EUR, PLN, USD, GBP, HUF, RON і BGN. За іншої валюти спосіб оплати буде приховано під час оформлення замовлення.

Обліковий запис GoPay: вам потрібні GoID, Client ID та Client Secret облікового запису мерчанта GoPay. Їх можна знайти в налаштуваннях інтеграції облікового запису. Тестовий обліковий запис sandbox має власні облікові дані. Налаштовувати сповіщення в обліковому записі GoPay не потрібно, але ваш магазин має бути доступний з інтернету.

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

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

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

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

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

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

5. Введіть GoID, Client ID та Client Secret для sandbox, залиште ввімкненим Test Mode і ввімкніть Enable/Disable.

6. Оформіть тестове замовлення. Коли все запрацює, введіть облікові дані для робочого середовища та зніміть прапорець Test Mode.

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

Усі налаштування розміщено на одній сторінці: WooCommerce > Settings > Payments > GoPay. Під описом платіжного шлюзу сторінка показує Sandbox mode — test payments only або Production mode — real payments. З'явиться попередження, якщо не вказано GoID, Client ID чи Client Secret для поточного режиму або GoPay не приймає валюту магазину. В обох випадках GoPay не пропонується під час оформлення замовлення. У списку способів оплати біля шлюзу буде вказано, що його потрібно налаштувати, доки не буде задано облікові дані поточного режиму. Після збереження кешовані токени доступу GoPay видаляються, тому нові облікові дані використовуються одразу.

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

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

Description: опис способу оплати, що відображається під час оформлення замовлення. За замовчуванням: Pay securely via GoPay - cards, wallets, bank transfers.

Облікові дані API

GoID, Client ID та Client Secret відображаються в обліковому записі мерчанта GoPay (налаштування інтеграції). Тестовий обліковий запис sandbox має власні облікові дані. Документацію API наведено на doc.gopay.com.

Test Mode: параметр Enable sandbox/test mode надсилає платежі на gw.sandbox.gopay.com з обліковими даними sandbox. Реальні кошти не списуються. Зніміть прапорець, щоб приймати реальні платежі з обліковими даними робочого середовища (gate.gopay.cz). За замовчуванням: увімкнено.

Sandbox GoID: GoID вашого тестового облікового запису GoPay.

Sandbox Client ID: OAuth Client ID тестового облікового запису.

Sandbox Client Secret: OAuth Client Secret тестового облікового запису.

Production GoID: ваш ідентифікатор мерчанта GoPay (GoID).

Production Client ID: OAuth Client ID від GoPay.

Production Client Secret: OAuth Client Secret від GoPay.

GoID містить лише цифри, наприклад 8123456789. Якщо ввести інше значення, сторінка покаже помилку, а попереднє значення збережеться.

Платіж

Payment Page Language: мова платіжної сторінки GoPay. За замовчуванням: Automatic (site language, then billing country). Автоматично використовується мова сайту; якщо GoPay її не підтримує, визначальною буде країна виставлення рахунку, а інакше використовуватиметься англійська. Також можна вибрати одну з 19 мов: чеську, англійську, словацьку, німецьку, польську, угорську, румунську, болгарську, хорватську, словенську, естонську, латиську, литовську, французьку, італійську, іспанську, португальську, українську або російську.

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

Сповіщення про платежі

Сповіщення повідомляє ваш магазин про здійснення платежу. URL сповіщення надсилається GoPay з кожним платежем, тому налаштовувати обліковий запис GoPay не потрібно. URL показано в налаштуваннях. Він має такий вигляд: https://your-site/?gopay-api=gopay_payment_notification. URL має бути доступний з інтернету: без захисту паролем, режиму технічного обслуговування чи брандмауера, що блокує доступ.

Сповіщення GoPay містять лише ID платежу, без підпису. Кожне сповіщення перевіряється запитом стану платежу до API GoPay; також платіж має бути створений плагіном для замовлення вашого магазину. Якщо стан неможливо отримати від GoPay, магазин відповідає помилкою, і GoPay надсилає сповіщення повторно. Без сповіщень замовлення підтверджується лише тоді, коли покупець повертається до магазину після оплати.

Додатково

Logging: параметр Enable logging записує події GoPay до WooCommerce > Status > Logs, джерело wcp_gopay_gateway. Помилки завжди записуються. Облікові дані, токени, дані карток, електронна адреса, телефон та адреса покупця ніколи не записуються. За замовчуванням: вимкнено.

Delete Data on Uninstall: параметр Delete plugin settings, cached access tokens and log files when uninstalled. Якщо його ввімкнено, під час видалення плагіна видаляються налаштування шлюзу, кешовані токени доступу GoPay і журнали. За замовчуванням: вимкнено.

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

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

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

Якщо платіж не завершено, його скасовано або строк його дії минув, покупець переходить на сторінку Pay for order з повідомленням The GoPay payment was not completed. You can try again or choose another payment method. або The GoPay payment was cancelled or has expired. You can try again or choose another payment method. На цій сторінці покупець може повторно оплатити неоплачене замовлення. Для вже оплаченого замовлення другий платіж GoPay не створюється.

Якщо GoPay не може розпочати платіж, покупець побачить коротке повідомлення, наприклад GoPay could not accept the payment details. Please check your billing details (e-mail, phone, address) or choose another payment method. або GoPay is temporarily unavailable. Please try again in a moment or choose another payment method. Технічну причину буде додано до приміток замовлення.

Спосіб оплати працює у класичному оформленні замовлення, у блоках Cart і Checkout та на сторінці Pay for order. У режимі sandbox блок Checkout показує Sandbox mode: no real payment will be made. Підтримується WooCommerce High-Performance Order Storage (HPOS).

Покупець вибирає спосіб оплати на сторінці GoPay; у WooCommerce вибрати його не можна. Плагін не підтримує підписки чи регулярні платежі, збережені картки, вбудовану платіжну форму, а також захоплення чи анулювання попередніх авторизацій у WooCommerce.

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

Статуси замовлень

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

Processing or Completed: платіж підтверджено. Статус визначається параметром Order Status After Payment. У примітці до замовлення показано ID платежу GoPay та платіжний інструмент. ID транзакції збігається з ID платежу GoPay.

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

Failed: останній платіж GoPay за неоплаченим замовленням скасовано або строк його дії минув.

Refunded: платіж GoPay за замовлення повністю повернено, наприклад через обліковий запис GoPay.

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

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

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

Повернення, зроблені в обліковому записі GoPay, надходять через сповіщення. Повне повернення змінює статус замовлення на «Повернено»; часткове додає примітку. Вони не реєструються автоматично як повернення WooCommerce.

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

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

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

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

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

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

GoPay не відображається під час оформлення замовлення: перевірте, чи активна ліцензія, чи ввімкнено Enable/Disable, чи задано для поточного режиму GoID, Client ID та Client Secret і чи вибрано валюту CZK, EUR, PLN, USD, GBP, HUF, RON або BGN. На сторінці Pay for order враховується валюта замовлення. Якщо облікові дані або валюта неправильні, на сторінці налаштувань з'явиться попередження.

Платіж пройшов, але замовлення все ще Pending payment: GoPay не вдалося отримати доступ до URL сповіщення, показаного в налаштуваннях, а покупець не повернувся до магазину. Вимкніть захист паролем, режим технічного обслуговування або правила брандмауера, що блокують URL. Переконайтеся, що задано облікові дані режиму, у якому було здійснено платіж, оскільки кожне сповіщення перевіряється з їх допомогою. Перегляньте WooCommerce > Status > Logs, джерело wcp_gopay_gateway. GoPay повторно надсилає сповіщення, на які не отримав успішної відповіді.

У сповіщенні зазначено «Order not found»: платіж створено не цим магазином або відповідне замовлення видалено.

У сповіщенні зазначено «Payment state could not be verified»: API GoPay недоступний або облікові дані цього режиму неправильні. GoPay надішле сповіщення повторно.

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

Тестові платежі не підтверджують реальне замовлення: тестове та робоче середовища ізольовані. Кожен платіж перевіряється в режимі, у якому його створили. Перемкніть Test Mode у потрібний режим і використовуйте відповідні облікові дані.

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

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

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

Для розробників: фільтр gopay_p_payment_payload змінює запит платежу, а gopay_p_icon — піктограму способу оплати.

Видалення

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

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