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: статус заказа, который устанавливается после успешной оплаты. Статус меняется за один шаг, без второй смены статуса.

Дополнительно

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:

Когда покупатель возвращается, плагин так же проверяет последний платёж через 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. Техническая причина добавляется в примечания к заказу и в журнал.

Способ оплаты работает на классическом оформлении заказа, в блоке оформления заказа и на странице 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.: Mollie не знает ID платежа для вашего тестового или боевого 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.