VibeFox Montonio for PrestaShop — Помощь

Требования

PrestaShop: от 8.0 до 9.x.

PHP: 8.0 или новее. Модуль не устанавливается на более старых версиях PHP.

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

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

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

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

Установка

1. В панели администратора откройте Modules > Module Manager и нажмите Upload a module. Выберите ZIP-файл модуля.

2. Когда загрузка завершится, нажмите Configure или позже найдите VibeFox Montonio Payment в списке модулей и нажмите Configure.

3. Вставьте лицензионный ключ VibeFox в поле License key в блоке лицензии в верхней части страницы Configure и нажмите Activate (см. раздел «Лицензионный ключ»).

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

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

При установке модуль создаёт статус заказа Montonio payment on hold. PrestaShop предлагает новый платёжный модуль для всех валют, стран и групп покупателей. Ограничить их можно в Payment > Preferences.

Настройка

Все настройки находятся на странице модуля: Modules > Module Manager > VibeFox Montonio Payment > Configure. У каждого раздела своя кнопка Save, которая сохраняет всю страницу. Над полями страница предупреждает, если отсутствуют ключи текущей среды (способ оплаты тогда скрыт на этапе оформления заказа), если валюта магазина не EUR и не PLN, и показывает Sandbox mode is on: payments are simulated and no real money is charged., пока sandbox включён. Title не может быть пустым.

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, рабочий режим — только рабочие ключи.

Sandbox mode: использует sandbox Montonio (тестовые платежи, без реальных денег). Переключаются и адрес API Montonio, и пара ключей. По умолчанию: включено. Выключайте только после ввода рабочих ключей. Платежи, сделанные в другой среде, для подтверждений и возвратов по-прежнему используют ключи своей среды.

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

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

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

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

Сохранённые секретные ключи больше не показываются. Поле остаётся пустым и показывает Saved — leave empty to keep it. Вводите новое значение, только если хотите его изменить.

Clear saved secret keys: отметьте ключ и нажмите Save, чтобы удалить его. Пустое поле сохраняет сохранённое значение.

Notification URL: адрес, на который Montonio отправляет уведомления о платежах. С человекопонятными URL он выглядит так: https://your-shop/module/wcp_montonio_payment/webhook. Вводить его никуда не нужно: модуль передаёт его Montonio с каждым платежом.

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

Debug log: записывает события платежей в logs/wc_mnt_debug.log.php в папке модуля. Файл нельзя открыть из браузера. Ошибки и предупреждения записываются всегда, даже когда эта опция выключена. Ключи, токены и данные покупателей никогда не записываются. По умолчанию: выкл.

Log: показывает размер и последние записи журнала. Нажмите Clear log, чтобы очистить его.

Delete data: если включено, при удалении модуля удаляются его настройки и журнал. Отключение модуля ничего не удаляет. Данные заказов (UUID Montonio, примечания) всегда сохраняются. По умолчанию: выкл.

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

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

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

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

Заказ отмечается оплаченным, только когда Montonio его подтвердит: уведомлением или при возврате покупателя. Затем заказ создаётся, и покупатель видит стандартную страницу подтверждения заказа с Your Montonio bank payment has been received. Если банк ещё не подтвердил платёж или заказ на удержании, страница показывает We are confirming your payment with Montonio. The order will be updated automatically — please do not pay again. Если банк позже отклоняет авторизованный платёж, страница показывает Your Montonio payment was not completed. Please contact us about this order.

Если Montonio сообщает, что платёж всё ещё в ожидании, когда покупатель возвращается, открывается страница Payment confirmation с тем же текстом и кнопкой Check again. Кнопка запрашивает у Montonio текущий статус платежа. Уведомление создаёт заказ, как только приходит.

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

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

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

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

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

No order yet: покупатель был отправлен в Montonio и не оплатил, или Montonio сообщает, что платёж в ожидании. Существует только корзина.

Payment accepted: Montonio подтвердил платёж (PAID) на точную сумму и валюту корзины. Платёж записывается с UUID заказа Montonio в качестве ID транзакции, а примечание показывает банк, UUID, сумму и среду.

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

Payment error: банк отклонил авторизованный платёж или покупатель его не завершил. Изменить заказ может только последний платёж корзины.

Refunded: платёж полностью возвращён через модуль.

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

Блок Montonio payment

На странице заказа показан блок Montonio payment с UUID заказа Montonio, средой (с меткой Sandbox для тестовых платежей), банком, статусом платежа, оплаченной и возвращённой суммой, историей возвратов и Montonio notes заказа.

Возвраты

В блоке Montonio payment введите сумму (подставляется сумма, которая ещё не возвращена), при необходимости причину (она сохраняется только в примечании к заказу) и нажмите Refund via Montonio. Подтвердите вопрос Refund this amount through Montonio? This cannot be undone. Поддерживаются полные и частичные возвраты. Нужно право на редактирование заказов; доступ к страницам модулей не требуется. Возвраты ограничены суммой, которую списал Montonio, поэтому при расхождении суммы можно вернуть не больше того, что покупатель фактически заплатил, а не сумму заказа. Возврат отправляется в ту среду, в которой был сделан платёж (sandbox или рабочая), поэтому ключи этой среды должны быть заданы. Если Montonio не принимает возврат, блок показывает ошибку и возврат не записывается. Отправленный возврат добавляется в историю возвратов и примечания со своим статусом и ID возврата Montonio. Полный возврат переводит заказ в статус Refunded. Частичный возврат статус не меняет. Возвраты доступны, когда Montonio сообщил, что платёж оплачен.

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

Модуль не создаёт кредитные накладные. Стандартные кнопки возврата PrestaShop на странице заказа не возвращают деньги через Montonio. Возвраты, сделанные в Montonio Partner System, добавляются в примечания, когда Montonio о них сообщает. Статус заказа и кредитные накладные автоматически не меняются. При необходимости обновите их вручную.

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

Модуль работает с лицензионным ключом VibeFox с vibefox.net. Блок лицензии License — VibeFox Montonio Payment — первый блок на странице Modules > Module Manager > VibeFox Montonio Payment > Configure, над настройками. Вставьте ключ в поле License key и нажмите Activate. После этого блок показывает ключ в скрытом виде, статус (например, дату, до которой действует лицензия, и ваш домен) и кнопки: Check now для повторной проверки статуса, Change key для ввода другого ключа и Remove key для удаления ключа из этого магазина. Ниже находятся строка Product: presta-payment-montonio и ссылка Manage licenses and domains in your account, которая открывает ваш аккаунт vibefox.net. Изменить ключ могут только сотрудники, у которых есть право Configure для модуля. Тексты блока соответствуют языку панели администратора (включены английский и русский).

Если ключ не принят, блок сообщает причину, например Key not found, This key belongs to another product, Domain limit reached или License expired on с датой. После смены адреса магазина или после освобождения слота домена в вашем аккаунте нажмите Check now. Если сервер лицензий недоступен, модуль продолжает работать по последнему известному статусу.

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

Без активного ключа Montonio не показывается покупателям на этапе оформления заказа. Если платёж всё же начат, покупатель видит This payment method is not available. Please choose another one. Витрина PrestaShop не знает, что вы вошли в панель администратора, поэтому способ оплаты скрыт и для вас: модуль можно настроить до покупки ключа, но проверить его на этапе оформления заказа нельзя. Напоминание появляется в Modules > Module Manager на вкладке Alerts. Существующие заказы не затрагиваются: уже начатые платежи по-прежнему подтверждаются, и возвраты работают.

Когда срок лицензии истекает, модуль продолжает работать, но для обновлений и поддержки нужно продление. Статус проверяется автоматически, пока вы работаете в панели администратора: раз в день в первые 14 дней после ввода ключа, затем раз в неделю. Cron-задача не нужна. Удаление или сброс модуля всегда удаляют лицензионный ключ и статус лицензии.

Решение проблем

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

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

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

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

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

Уведомление отвечает Temporarily unavailable: корзину в тот же момент подтверждал другой запрос, или заказ не удалось создать (например, модуль отключён). Montonio повторит уведомление. Причину смотрите в поле Log.

Покупатель видит ошибку при выборе Montonio: посмотрите поле Log на странице модуля. 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 отклонил данные платежа; причина записана в журнал.

Заказ после оплаты в статусе Montonio payment on hold: прочитайте примечания в блоке Montonio payment (см. Статусы заказов), затем выполните заказ или сделайте возврат.

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

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

Для разработчиков модуль предлагает хуки actionWcpMontonioSupportedCurrencies, actionWcpMontonioOrderData и actionWcpMontonioLocale для изменения поддерживаемых валют, данных платежа и языка страницы Montonio.

Удаление

Откройте Modules > Module Manager, нажмите меню рядом с VibeFox Montonio Payment и выберите Uninstall. Лицензионный ключ и статус лицензии этого модуля всегда удаляются. Если Delete data включено, настройки модуля и журнал удаляются. Если выключено, все настройки сохраняются для повторной установки. Записи о платежах и возвратах Montonio и статус заказа Montonio payment on hold всегда сохраняются, поэтому заказы, оплаченные ранее, можно вернуть и после повторной установки. Существующие заказы сохраняют свои платёжные примечания и ID транзакций.

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