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

Вимоги

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

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

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

Валюта магазину: одна з валют, які підтримує Mollie: AED, AUD, BGN, BRL, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF, ILS, ISK, JPY, MXN, MYR, NOK, NZD, PHP, PLN, RON, SEK, SGD, THB, TWD, USD, ZAR. Для інших валют спосіб оплати приховується в оформленні замовлення. Які способи оплати пропонує Mollie, залежить від валюти та вашого облікового запису.

Доступ до вашого сайту з інтернету: Mollie надсилає вебхуки у ваш магазин, тому сайт має бути доступним з інтернету. Без вебхуків замовлення все одно оновлюються, коли покупець повертається з Mollie.

Обліковий запис Mollie: потрібні API-ключі з розділу Mollie Dashboard > Developers > API keys. Тестові ключі починаються з test_, робочі — з live_. Самі способи оплати вмикаються у вашому обліковому записі Mollie.

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

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

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

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

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

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

5. Введіть тестовий і робочий API-ключі (див. розділ «Налаштування»). Вебхук у Mollie налаштовувати не потрібно.

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

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

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

Під час збереження API-ключ, який не починається з test_ або live_ з наступними щонайменше 30 літерами та цифрами, не зберігається: з'являється помилка, а попереднє значення залишається.

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

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

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

Description: опис способу оплати, який бачить покупець в оформленні замовлення. За замовчуванням: Pay securely via Mollie.

API-ключі

Ваші API-ключі знаходяться в розділі Mollie Dashboard > Developers > API keys. Налаштовувати вебхук не потрібно: плагін передає URL вебхука з кожним платежем. URL відображається в цьому розділі і має такий вигляд: https://your-site/?wc-api=molg_mollie_webhook. Він має бути доступним з інтернету, інакше замовлення оновлюються лише тоді, коли покупець повертається з Mollie.

Test Mode: Enable test mode використовує тестовий API-ключ для нових платежів. Реальні платежі не проводяться. На тестовій сторінці оплати Mollie можна обрати результат (paid, failed, cancelled, expired). Покупці бачать у оформленні замовлення напис Test mode: no real payment will be made. Платежі, створені в іншому режимі, для перевірки статусу та повернень продовжують використовувати ключ свого режиму. За замовчуванням: увімкнено.

Test API Key: ваш тестовий API-ключ Mollie (починається з test_).

Live API Key: ваш робочий API-ключ Mollie (починається з live_).

Замовлення

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

Processing: стандартне значення WooCommerce (за замовчуванням). Замовлення лише з віртуальними товарами для завантаження отримують статус Виконано.

Completed: кожне оплачене замовлення отримує статус Виконано.

Додатково

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

Delete Data on Uninstall: Remove the plugin settings and logs when uninstalling. Якщо позначено, налаштування плагіна та його файли журналів видаляються разом із плагіном. ID платежів Mollie, збережені в замовленнях, зберігаються. За замовчуванням: вимкнено.

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

Покупець обирає спосіб оплати (за замовчуванням Mollie) і оформлює замовлення. Плагін створює платіж Mollie на суму замовлення у валюті замовлення (JPY та ISK без десяткових знаків) з описом Order # та номером замовлення і надсилає покупця на розміщену на стороні Mollie сторінку оплати. Там покупець обирає один із способів оплати, увімкнених у вашому обліковому записі Mollie, і сплачує.

Вебхуки Mollie не мають підпису, лише ID платежу. Тому плагін ніколи не довіряє вебхуку як такому: він запитує платіж з API Mollie вашим API-ключем, перевіряє, що платіж належить замовленню, і порівнює сплачену суму та валюту із замовленням. Замовлення позначається оплаченим лише після такого підтвердження від Mollie. Плагін обробляє такі статуси платежів Mollie:

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

authorized: платіж авторизовано, але не захоплено. Замовлення переходить у статус На утриманні з приміткою; захопіть платіж у Mollie Dashboard.

open (bank transfer): Mollie очікує на кошти. Замовлення переходить у статус На утриманні, щоб WooCommerce не скасував його як неоплачене.

open, pending: платіж ще не завершено. Замовлення не змінюється.

failed, expired, canceled: остання спроба оплати не вдалася. Неоплачене замовлення позначається як Невдалий.

chargeback: Mollie повідомляє про суму, повернуту покупцю через оскарження. Додається примітка, замовлення переходить у статус На утриманні.

Коли покупець повертається, плагін так само перевіряє останній платіж через API Mollie. Оплачений платіж веде на сторінку отриманого замовлення. Якщо платіж скасовано, він не вдався, минув строк або не завершено, покупець переходить на сторінку Pay for order з повідомленням, наприклад You cancelled the Mollie payment. You can try again or choose another payment method. або The Mollie payment has expired. Please try again or choose another payment method.

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

Якщо Mollie не може розпочати платіж, покупець бачить коротке повідомлення, наприклад The payment provider could not be reached. Please try again in a moment., This payment method is temporarily unavailable. Please choose another payment method. (невірний API-ключ) або Mollie cannot accept a payment of this amount or currency. Please choose another payment method. Технічна причина додається до приміток замовлення та журналу.

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

Покупець обирає спосіб Mollie на сторінці Mollie, а не у вашому оформленні замовлення. Плагін не підтримує підписки та регулярні платежі, збережені картки чи мандати, Mollie Components (поля для картки на вашому сайті), кнопки Apple Pay чи PayPal express та Orders API, тож Mollie не пропонує для цих платежів способи, яким потрібні рядки замовлення (наприклад, деякі варіанти Klarna, Billie або in3). Авторизовані платежі захоплюються або анулюються в Mollie Dashboard, а не з WooCommerce.

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

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

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

Processing or Completed: платіж підтверджено. Статус відповідає налаштуванню Order Status After Payment. Примітка до замовлення показує платіж Mollie, спосіб оплати та режим. ID транзакції — це ID платежу Mollie (tr_...), яким сплачено замовлення.

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

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

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

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

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

Повернення та чарджбеки, створені в Mollie Dashboard, не перетворюються на повернення WooCommerce. Чарджбек лише додає примітку.

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

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

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

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

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

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

Mollie не відображається в оформленні замовлення: перевірте, що ліцензія активна, що Enable/Disable увімкнено і що в поточному режимі є API-ключ: Test API Key у тестовому режимі, Live API Key у робочому режимі. Перевірте, що валюта магазину (або валюта замовлення на сторінці Pay for order) підтримується Mollie. На сторінці налаштувань є попередження для кожної з цих проблем.

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

Webhook answers Unknown payment.: ID платежу невідомий Mollie для вашого тестового або робочого API-ключа, наприклад це платіж іншого облікового запису Mollie.

Webhook answers Payment ID mismatch.: за своїми даними платіж не належить цьому замовленню. Замовлення не змінюється.

Webhook answers Failed to fetch payment.: API Mollie був недоступний. Mollie повторить вебхук пізніше.

API-ключ не зберігається: ключ має починатися з test_ або live_, після чого йдуть щонайменше 30 літер і цифр. Скопіюйте ключ із Mollie Dashboard ще раз.

Платіж не створюється: примітка до замовлення та журнал показують HTTP-код і повідомлення Mollie. 401 означає неправильний API-ключ; 422 вказує на поле запиту, наприклад суму або валюту, які Mollie не приймає. Увімкніть Logging і перегляньте WooCommerce > Status > Logs, джерело wcp_mollie_gateway.

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

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

Інші валюти: розробники можуть змінити список валют за допомогою фільтра molg_supported_currencies.

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

Видалення

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

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