VibeFox Montonio for WooCommerce — Помощь

Требования

WordPress: 6.0 или новее.

WooCommerce: 7.0 или новее, установлен и активен. Без WooCommerce плагин не активируется.

PHP: 8.0 или новее.

Валюта: валюта магазина или заказа должна быть EUR или PLN. Для любой другой валюты способ оплаты скрывается на странице оформления заказа.

Учётная запись Montonio: нужны ключ доступа и секретный ключ вашего магазина из Montonio Partner System. Ключи sandbox и рабочие ключи различаются, поэтому для каждой используемой среды нужна своя пара. Больше ничего в Montonio настраивать не нужно: адрес уведомлений передаётся с каждым платежом.

Публичный сайт: ваш сайт должен быть доступен из интернета, чтобы получать уведомления Montonio. Иначе заказы всё равно подтверждаются, когда покупатель возвращается в магазин.

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

Установка

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

2. Нажмите Activate.

3. Откройте настройки: WooCommerce > Settings > Payments > Montonio > Manage или нажмите Settings под названием плагина на странице Plugins.

4. Введите лицензионный ключ VibeFox в блоке лицензии в верхней части страницы и нажмите Activate.

5. В Montonio Partner System откройте Stores > your store > API keys и скопируйте ключ доступа и секретный ключ sandbox. Вставьте их в настройки и оставьте включённым Sandbox mode.

6. Включите Enable/Disable и проверьте платёж в sandbox. Затем введите рабочие ключи и снимите отметку Sandbox mode.

Настройка

Все настройки находятся на одной странице: WooCommerce > Settings > Payments > Montonio. Над полями страница предупреждает, если нет ключей текущей среды (тогда способ оплаты скрывается на странице оформления заказа), и если валюта магазина не EUR и не PLN. Пока sandbox включён, она показывает Sandbox mode is on: payments are simulated and no real money is charged. В списке способов оплаты Montonio помечен как требующий настройки, пока не заполнены оба ключа текущей среды.

Общие

Enable/Disable: Enable Montonio bank payments включает или выключает способ оплаты. По умолчанию: выключено.

Title: название способа оплаты, которое видит покупатель на странице оформления заказа. По умолчанию: Bank payment (Montonio).

Description: текст под способом оплаты на странице оформления заказа. По умолчанию: Pay directly from your bank account. You will be redirected to Montonio to choose your bank.

Ключи API

Ключи получаются в Montonio Partner System: Stores > your store > API keys. Ключи sandbox и рабочие ключи различаются. Sandbox использует только ключи sandbox, рабочий режим — только рабочие ключи. В этом разделе настроек также показан адрес уведомлений. Он выглядит так: https://your-site/wc-api/wc_mnt_payment/. Вводить его никуда не нужно: плагин передаёт его в Montonio с каждым платежом.

Sandbox mode: Use the Montonio sandbox (test payments, no real money). Переключает и адрес API Montonio, и пару ключей. По умолчанию: включено. Выключайте только после ввода рабочих ключей.

Sandbox access key: ключ доступа (UUID) вашего магазина в sandbox Montonio.

Sandbox secret key: секретный ключ вашего магазина в sandbox Montonio.

Live access key: ключ доступа (UUID) вашего магазина в рабочей среде Montonio.

Live secret key: секретный ключ вашего магазина в рабочей среде Montonio.

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

Debug log: Log payment events записывает все события платежей в WooCommerce > Status > Logs, источник wcp_montonio_payment. Ошибки записываются всегда, даже если эта опция выключена. Ключи, токены и данные покупателей никогда не записываются. По умолчанию: выключено.

Delete data: Delete the gateway settings and logs when the plugin is deleted. Деактивация плагина ничего не удаляет. Данные заказов (UUID Montonio, примечания) сохраняются всегда. По умолчанию: выключено.

Уведомления о платежах

Montonio сообщает магазину о каждом платеже подписанным токеном. Токен приходит двумя путями: серверным уведомлением на адрес уведомлений и вместе с покупателем, когда он возвращается в магазин. Проверяются оба: подпись секретным ключом, срок действия, ключ доступа и то, что платёж был создан вашим магазином для этого заказа в той же среде. Токены, которые не проходят проверку, отклоняются. Каждый статус применяется только один раз, поэтому повторные уведомления не добавляют примечаний, писем или изменений остатков.

Оформление заказа

Покупатель выбирает способ оплаты (по умолчанию Bank payment (Montonio)) и оформляет заказ. Плагин создаёт платёж Montonio на сумму заказа в валюте заказа и отправляет покупателя на страницу оплаты Montonio. Там покупатель выбирает банк и оплачивает. Банки страны платёжного адреса покупателя показываются первыми (для заказов в PLN — Польша). Платёж отображается как Order и номер заказа. Страница Montonio открывается на языке магазина, если это немецкий, английский, эстонский, финский, литовский, латышский, польский или русский; в остальных случаях — на английском. В режиме sandbox на странице оформления заказа под описанием отображается SANDBOX MODE — test payment, no real money is charged.

Заказ отмечается оплаченным только после подтверждения Montonio со статусом PAID и точными суммой и валютой заказа. После оплаты покупатель возвращается на страницу подтверждения заказа в вашем магазине. Пока Montonio не подтвердил платёж, на этой странице показано Montonio has not confirmed your payment yet. The order is updated as soon as the bank confirms it, and you will receive an e-mail then. Если платёж отменён или отклонён, покупатель возвращается на страницу Pay for order и видит одно из сообщений: The payment was cancelled or rejected by the bank. You can try again or choose another payment method., The payment was not completed. You can try again or choose another payment method. или Montonio could not complete the payment. Please try again or choose another payment method.

Покупатель может оплатить неоплаченный заказ повторно со страницы Pay for order. Перед созданием нового платежа плагин запрашивает у Montonio статус предыдущего. Если он уже оплачен, заказ подтверждается, и второй платёж не создаётся.

Если Montonio не может начать платёж, покупатель видит короткое сообщение, например Montonio is temporarily unavailable. Please try again in a few minutes or choose another payment method., и может выбрать другой способ оплаты. Ошибка Montonio добавляется в примечания к заказу и в журнал.

Способ оплаты работает на классическом оформлении заказа, в блоке оформления заказа и на странице Pay for order. Он совместим с WooCommerce High-Performance Order Storage (HPOS).

Плагин принимает только банковские платежи (инициирование платежа). В нём нет оплаты картами, BLIK, Apple Pay или Google Pay, Pay Later или финансирования, доставки Montonio, подписок, сохранённых способов оплаты и выбора банка на вашем сайте.

Заказы и возвраты

Статусы заказа

Ожидает оплаты: покупатель отправлен в Montonio и ещё не оплатил. Примечание добавляется, когда Montonio сообщает, что платёж ожидает обработки.

В обработке или Выполнен: Montonio подтвердил платёж (PAID). Заказ получает стандартный статус WooCommerce для оплаченных заказов. В примечании к заказу показаны банк, UUID платежа Montonio, сумма и среда. ID транзакции — это UUID платежа Montonio.

На удержании: банк ещё не подтвердил платёж (AUTHORIZED); заказ станет оплаченным, когда Montonio сообщит PAID. Заказ также переводится в статус «На удержании», если Montonio сообщил сумму или валюту, отличающиеся от заказа, если платёж в sandbox поступил, пока магазин работает в рабочем режиме, или если платёж пришёл после отмены заказа. Примечание к заказу объясняет причину. Проверьте платёж в Montonio Partner System и выполните заказ или сделайте возврат.

Неудачный: покупатель не завершил платёж или банк его отклонил. Только последний платёж неоплаченного заказа может перевести заказ в этот статус. Покупатель может повторить попытку со страницы Pay for order.

Оплаченные, отменённые или возвращённые заказы не переоткрываются последующими уведомлениями. Если для уже оплаченного заказа поступает второй платёж, заказ не меняется. Примечание попросит вас вернуть второй платёж в Montonio Partner System.

Возвраты

Откройте заказ, нажмите Refund, введите сумму и нажмите Refund via Bank payment (Montonio) (на кнопке используется название способа оплаты). Для заказов, оплаченных через Montonio, поддерживаются полные и частичные возвраты. Возврат отправляется в среду, в которой был совершён платёж (sandbox или рабочая), поэтому ключи этой среды должны быть заданы. Если Montonio не принимает возврат, WooCommerce показывает ошибку, и возврат не регистрируется. Отправленный возврат добавляется в примечания к заказу с его статусом и ID возврата Montonio.

Montonio позже подтверждает или отклоняет каждый возврат уведомлением. Подтверждение добавляется в примечания к заказу. Если Montonio отклоняет возврат, примечание сообщит, что деньги покупателю не возвращены; проверьте это в Montonio Partner System и исправьте возврат в WooCommerce.

Возвраты, сделанные в Montonio Partner System, добавляются в примечания к заказу, когда Montonio о них сообщает. Автоматически они не регистрируются как возвраты WooCommerce. При необходимости создайте ручной возврат в WooCommerce.

Лицензионный ключ

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

Один ключ работает на одном домене. Удаление ключа с сайта не освобождает слот домена. Освободите его в своём аккаунте на vibefox.net.

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

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

Устранение неполадок

Montonio не появляется на странице оформления заказа: проверьте, что лицензия активна, Enable/Disable включён, заполнены оба ключа текущей среды (Sandbox access key и Sandbox secret key в режиме sandbox, Live access key и Live secret key в рабочем режиме), а валюта магазина или заказа — EUR или PLN. Страница настроек показывает предупреждение, если ключи не заполнены или валюта не поддерживается.

Платёж прошёл, но заказ остаётся в статусе «Ожидает оплаты»: уведомление не дошло до вашего магазина. Проверьте, что сайт доступен из интернета и что ключи в настройках относятся к среде платежа. Заказ также подтверждается, когда покупатель возвращается в магазин после оплаты, и когда он пытается оплатить тот же заказ повторно.

Уведомление отвечает Invalid token: подпись токена, срок действия или ключ доступа не совпали. Проверьте, что ключ доступа и секретный ключ скопированы правильно, относятся к нужной среде и что часы сервера выставлены верно.

Уведомление отвечает Payment does not belong to this order или Wrong environment: платёж не был создан этим магазином для этого заказа или создан в другой среде (sandbox или рабочей). Это случается, когда два магазина используют один аккаунт Montonio и одинаковые номера заказов.

Уведомление отвечает Gateway not configured: ключи Montonio не заданы. Введите ключи; Montonio повторит уведомление.

Покупатель видит ошибку при оформлении заказа: откройте примечания к заказу или включите Debug log и посмотрите WooCommerce > Status > Logs, источник wcp_montonio_payment. This payment method is temporarily unavailable. Please choose another payment method. обычно означает неверные или отсутствующие ключи. Montonio could not start the payment. Please check your order details or choose another payment method. означает, что Montonio отклонил данные платежа; причина указана в примечании.

Заказ в статусе «На удержании» после оплаты: прочитайте примечание к заказу. Банк ещё не подтвердил платёж, оплаченные сумма или валюта отличаются от заказа, платёж в sandbox пришёл в рабочем режиме, или платёж пришёл после отмены заказа. Проверьте платёж в Montonio Partner System.

Платежи в sandbox не подтверждают рабочий заказ: платёж в sandbox никогда не завершает заказ, пока магазин работает в рабочем режиме; вместо этого заказ переводится в статус «На удержании». Переключите Sandbox mode на нужную среду и используйте её ключи.

Возврат не удаётся с сообщением о среде: платёж был совершён в среде sandbox или рабочей, а ключи этой среды не заданы. Введите их и повторите попытку.

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

Удаление

Деактивация плагина сохраняет все данные. Чтобы удалить его, деактивируйте и удалите плагин на странице Plugins. Лицензионный ключ и статус лицензии этого плагина удаляются всегда. Настройки шлюза и журналы удаляются только если была включена опция Delete data. В противном случае они сохраняются для повторной установки. Существующие заказы сохраняют свои платёжные примечания и ID транзакций.

Montonio является товарным знаком его владельца. Этот плагин не связан с Montonio и не одобрен компанией Montonio.