VibeFox MultiSafepay for PrestaShop — Помощь

Требования

PrestaShop: от 8.0 до 9.x.

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

Валюта: валюта корзины должна быть одной из тех, что принимает MultiSafepay, например EUR, USD, GBP, PLN, CHF, SEK, DKK или NOK. Для других валют способ оплаты при оформлении заказа не показывается.

Аккаунт MultiSafepay: нужен API-ключ вашего сайта в MultiSafepay Control. Тестовый и рабочий аккаунты имеют разные ключи. Больше ничего настраивать в MultiSafepay не нужно: адрес уведомлений передаётся с каждым платежом.

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

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

Установка

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

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

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

4. Вставьте тестовый и/или рабочий API-ключ из MultiSafepay Control (см. Настройка).

5. Включите Enable/Disable и нажмите Save. Проверьте оплату с включённым Test mode, затем выключите его, чтобы принимать настоящие платежи.

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

Настройка

Все настройки находятся на странице модуля: Modules > Module Manager > VibeFox MultiSafepay Gateway > Configure. У каждого раздела есть своя кнопка Save, которая сохраняет всю страницу. Над полями страница показывает Test mode: new payments use the MultiSafepay test environment (no real payments)., пока включён тестовый режим, предупреждает, если у текущего режима нет API-ключа (тогда способ оплаты при оформлении заказа не показывается), и если MultiSafepay не принимает валюту по умолчанию вашего магазина. Страница не сохраняется без Title.

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

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

Title: название способа оплаты, которое покупатель видит при оформлении заказа. Оно же сохраняется в заказе. По умолчанию: MultiSafepay. Обязательно.

Description: текст под способом оплаты при оформлении заказа. По умолчанию: Pay securely with iDEAL, cards, Bancontact, PayPal and more via MultiSafepay.

API-ключи

API-ключ находится в MultiSafepay Control > Manage settings > Website settings. В этом разделе есть ссылки на тестовый аккаунт (testmerchant.multisafepay.com) и рабочий аккаунт (merchant.multisafepay.com). Ключи у них разные. Тестовый режим использует только тестовый ключ, рабочий режим — только рабочий ключ.

Test mode: Use the MultiSafepay test environment (no real payments). Переключает и адрес API, и API-ключ. Уже совершённые платежи для проверки статуса и возвратов по-прежнему используют среду, в которой были созданы. По умолчанию: включено. Пока режим включён, покупатели видят под способом оплаты Test mode: no real payment will be made.

Test API key: API-ключ вашего тестового аккаунта MultiSafepay.

Live API key: API-ключ вашего рабочего аккаунта MultiSafepay.

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

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

Уведомления

Ничего настраивать не нужно. Поле Notification URL показывает адрес, который передаётся в MultiSafepay с каждым платежом. С ЧПУ-адресами он выглядит так: https://your-shop/module/wcp_multisafepay_gateway/webhook, возможно с кодом языка, например /en/. Уведомление лишь сообщает модулю, какой платёж изменился: статус, сумма и валюта всегда считываются через API MultiSafepay с вашим API-ключом до создания или изменения заказа. Уведомления о платежах, начатых не в вашем магазине, игнорируются. Уведомление работает, пока магазин находится в режиме обслуживания, и не блокируется ограничением по стране для вашего магазина.

Заказы

Order status after payment: статус оплаченного заказа. Статус устанавливается сразу, одним изменением статуса и одним письмом покупателю.

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

Debug log: Log API calls and notifications записывает в logs/mspg_debug.log.php в папке модуля. Файл нельзя открыть из браузера. Ошибки и предупреждения записываются всегда. API-ключи и данные покупателей никогда не записываются. По умолчанию: выключено.

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

Delete data on uninstall: если включено, при удалении модуля удаляются настройки и журнал. Платёжные данные MultiSafepay по заказам и статус заказа всегда сохраняются, поэтому возвраты по старым заказам остаются возможны. Отключение модуля ничего не удаляет. По умолчанию: выключено.

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

На этапе оплаты покупатель выбирает способ оплаты (по умолчанию MultiSafepay, с логотипом MultiSafepay) и подтверждает. Модуль создаёт платёж MultiSafepay на сумму корзины в валюте корзины и отправляет покупателя на платёжную страницу MultiSafepay. Там покупатель выбирает любой способ оплаты, включённый в вашем аккаунте MultiSafepay, и платит. Адрес для счёта, e-mail, телефон и язык покупателя передаются в MultiSafepay, а платёж отображается как Order #, номер корзины и название вашего магазина. На этом этапе заказа ещё нет.

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

Если покупатель отменяет оплату на странице MultiSafepay, либо платёж отклонён или истёк, покупатель возвращается к оформлению заказа с сохранённой корзиной и одним из сообщений: The MultiSafepay payment was cancelled. You can try again or choose another payment method., The payment was declined. Please try again or choose another payment method. или The payment session has expired. Please try again.

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

Если MultiSafepay не может начать платёж, покупатель остаётся при оформлении заказа с коротким сообщением, например Could not connect to MultiSafepay. Please try again in a moment. или MultiSafepay cannot accept this order amount or currency. Please choose another payment method. Техническая причина записывается в журнал.

Модуль предлагает один способ оплаты, ведущий на платёжную страницу MultiSafepay. У него нет отдельных платёжных способов PrestaShop для каждого метода MultiSafepay, нет встроенных полей карты, кнопок экспресс-оплаты Apple Pay или Google Pay, подписок, периодических платежей или сохранённых карт, а также нельзя выполнить списание или отмену из PrestaShop. Данные корзины не передаются, поэтому способы отложенной оплаты, которым они нужны (например, Klarna, in3 или Riverty), для этих заказов MultiSafepay не предлагает.

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

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

Заказа пока нет: покупатель был отправлен в MultiSafepay и не оплатил, либо MultiSafepay ещё не подтвердил платёж. Существует только корзина.

Payment accepted или Delivered: MultiSafepay подтвердил платёж (завершён или отгружен). Статус соответствует Order status after payment. Платёж записывается с ID заказа MultiSafepay в качестве ID транзакции, а примечание показывает платёж, способ оплаты и среду.

MultiSafepay payment on hold before payment: платёж ещё не окончательно проведён (его проверяет MultiSafepay) или зарезервирован (авторизован). Чтобы получить деньги, выполните списание зарезервированного платежа в MultiSafepay Control. Заказ автоматически переходит в оплаченный статус, когда MultiSafepay сообщает, что платёж завершён.

MultiSafepay payment on hold after payment: MultiSafepay подтвердил сумму или валюту, отличающиеся от суммы корзины (например, корзину изменили после начала платежа), тестовый платёж был завершён, пока модуль работает в рабочем режиме (настоящие деньги не получены, платёж не записан), или платёж был завершён после отмены заказа. Примечание объясняет это. Проверьте транзакцию в MultiSafepay Control и выполните заказ или сделайте возврат.

MultiSafepay payment on hold after a chargeback: MultiSafepay сообщил о чарджбэке по оплаченному заказу: деньги были списаны с вашего счёта.

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

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

Оплаченный или возвращённый заказ никогда не открывается заново из-за запоздавшего уведомления. Если для уже оплаченной корзины завершается второй платёж, заказ не меняется. Примечание просит вас вернуть дубликат в MultiSafepay Control.

Блок оплаты MultiSafepay

На странице заказа показан блок MultiSafepay payment с ID заказа MultiSafepay, способом оплаты, статусом, суммой оплаты и возврата, значком Test mode для тестовых платежей, историей возвратов и MultiSafepay notes заказа.

Возвраты

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

Модуль не создаёт кредитные накладные. Стандартные кнопки возврата PrestaShop на странице заказа не возвращают деньги через MultiSafepay.

Возвраты, сделанные в MultiSafepay Control, добавляются в заметки, когда MultiSafepay о них сообщает. Статус заказа и кредитные накладные автоматически не меняются. При необходимости обновите их вручную.

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

Модуль работает с лицензионным ключом VibeFox с vibefox.net. Блок лицензии License — VibeFox MultiSafepay Gateway — первый блок на странице Modules > Module Manager > VibeFox MultiSafepay Gateway > Configure, над настройками. Введите ключ в поле License key и нажмите Activate. После этого блок показывает ключ в скрытом виде, статус (например, дату, до которой действует лицензия, и ваш домен), а также кнопки Check now для повторной проверки статуса, Change key для ввода другого ключа и Remove key для удаления ключа из этого магазина. Ниже находятся строка Product: presta-payment-multisafepay и ссылка 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.

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

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

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

MultiSafepay не появляется при оформлении заказа: проверьте, что лицензия активна, Enable/Disable включено, у текущего режима есть API-ключ (Test API key в тестовом режиме, Live API key в рабочем режиме) и валюта корзины принимается MultiSafepay. Страница настроек показывает предупреждение, если ключ отсутствует или валюта магазина не принимается. В Payment > Preferences проверьте, разрешён ли модуль для валюты корзины, страны покупателя и группы покупателя.

Платёж прошёл, но заказ не создан: уведомление не дошло до вашего магазина. Проверьте, что магазин доступен из интернета и что задан API-ключ среды платежа, потому что модуль получает статус через API MultiSafepay. Если API недоступен или ключ отсутствует, уведомление отвечает ERROR, и MultiSafepay повторяет его. Заказ также создаётся, когда покупатель возвращается в магазин и когда пытается снова оплатить ту же корзину.

Уведомление отвечает Invalid request: в запросе не было корректного ID транзакции. Уведомления от MultiSafepay всегда содержат его.

Покупатель видит ошибку при выборе MultiSafepay: включите Debug log и посмотрите поле Log на странице модуля. This payment method is temporarily unavailable. Please choose another payment method. обычно означает неверный или отсутствующий API-ключ. MultiSafepay cannot accept this order amount or currency. Please choose another payment method. означает, что MultiSafepay отклонил сумму или валюту.

Заказ в статусе MultiSafepay payment on hold: прочитайте примечания в блоке MultiSafepay payment. Платёж может быть не окончательно проведён или зарезервирован, оплаченная сумма или валюта могут отличаться от корзины, тестовый платёж мог прийти в рабочем режиме, платёж мог прийти после отмены заказа или был чарджбэк. Проверьте транзакцию в MultiSafepay Control.

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

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

Удаление

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

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