new

msSezzle

Оплата частями через Sezzle для miniShop2
Автор дополнения
Артур Шевченко
Пакетов
31
Закачек
3 660
Обычно отвечает в течение суток
Автор дополнения
Пакетов
31
Закачек
3 660
Обычно отвечает в течение суток
Версия 1.2.3-rc
Дата выпуска 20.11.2026
Загрузки 0
Внимание, этот компонент несовместим с MODX 3.
Что делает
  • Добавляет в оформление заказа оплату частями через Sezzle.
  • Магазин запрашивает ссылку на оплату, покупатель проходит проверку и подтверждает рассрочку на стороне сервиса.
  • После подтверждения заказ автоматически переводится в статус «Оплачен».
Особенности
  • Собственных таблиц пакет не создаёт — устанавливается и удаляется чисто.
  • Все параметры интеграции задаются системными настройками, правки кода не нужны.
  • Тестовый режим позволяет обкатать сценарий без реальных платежей.
Требования
  • MODX Revolution 2.5+, PHP 7.4+
  • miniShop2
  • Merchant-аккаунт Sezzle

1.2.3-rc

  • PERF: widget.js (оркестратор Sezzle) подключается с атрибутом defer и больше не блокирует разбор страницы. Конфиг window.msSezzleConfig по-прежнему печатается inline до скрипта, порядок выполнения внутри widget.js не менялся; сам price-widget Sezzle и раньше грузился async.

1.2.2-rc

  • FIX: сбои оплаты теперь всегда попадают в журнал mxLogger (тег payment, уровень error) — даже если в настройках выключено логирование (msszl_debug). Раньше при выключенной настройке ошибки Sezzle пропадали бесследно, и о неудавшейся оплате узнавали только от покупателя. Настройка по-прежнему управляет отладочными записями (debug, info, warning). В журнал попадают: ошибки и неверные ответы API Sezzle, сбои вебхука и страницы возврата (пустое или битое тело, неверная подпись, заказ не найден, обработчик оплаты не загружен), заказ без идентификатора сессии Sezzle при обработке вебхука. Если mxLogger не установлен, поведение прежнее: ничего не пишется и новых записей в журнале MODX не появляется.
  • FIX: если не удалось сменить статус заказа (оплачен или отказ), в журнал пишется ошибка с номером заказа и целевым статусом. Раньше результат смены статуса не проверялся, и заказ мог остаться неоплаченным без единого следа. Ожидаемые отказы miniShop2 не считаются сбоем: «статус уже такой» (повторный вебхук) не пишется, «финальный/фиксированный статус» пишется предупреждением. Ход обработки при этом не меняется.
  • Ожидаемые события не считаются ошибкой: отмена оплаты покупателем, повторный вебхук, уже оплаченный заказ — они пишутся как info или предупреждение.
  • Описания настроек msszl_debug и msszl_log_level уточнены: ошибки оплаты пишутся всегда.

1.2.1-rc

  • FIX: отмену платежа нельзя больше подделать. Раньше любой, кто знал номер заказа, мог открыть адрес возврата с action=cancel и перевести неоплаченный заказ Sezzle в статус «отказ». Теперь ссылка отмены, которую модуль передаёт в Sezzle, подписана (HMAC-SHA256 на приватном ключе Sezzle), и статус меняется только по верной подписи. Без подписи или с неверной статус не трогается, в журнал пишется предупреждение, покупатель попадает на страницу исхода как обычно. Заказы, по которым сессия Sezzle открыта до обновления, при отмене статус не меняют.

1.2.0-rc

  • FEATURE: статус заказа уточняется прямо на странице возврата, до её отрисовки. Плагин на OnLoadWebDocument видит в адресе msorder, убеждается, что заказ оплачивается через Sezzle и ещё не оплачен, и синхронно спрашивает статус у Sezzle (GET /order/{uuid}); при подтверждённом захвате заказ переводится в статус «оплачен». Нужно для случаев, когда пользователь попадает на страницу возврата мимо callback-обработчика — перезагрузка, кнопка «назад», закладка, оборванный редирект — и вебхук order.captured ещё не пришёл: раньше оплаченный заказ показывался как неоплаченный. Статус при этом никогда не понижается: «отказ» по-прежнему ставят только отмена платежа и вебхук.

1.1.1-rc

  • FIX: callback возврата и обработчик вебхука загружали платёжный обработчик через несуществующий метод miniShop2::loadPaymentHandler() — оба падали с фатальной ошибкой, из-за чего возврат из Sezzle не доходил до страницы благодарности, а вебхук не менял статус заказа. Теперь обработчик берётся штатным API miniShop2 (msPayment::loadHandler).

1.1.0-rc

  • FIX: callback возврата (assets/components/mssezzle/payment/mssezzle.php) теперь кладёт исход платежа в адрес редиректа: при отказе или отмене к URL добавляется &canceled=1, при успехе адрес прежний. Раньше исход терялся, и страница возврата не могла отличить отмену от оплаты, если msszl_failure_page_alias указывает на ту же страницу, что и msszl_success_page_alias.
  • FEATURE: вывод on-site виджета Sezzle "Pay in 4" переведён со сниппета на плагин, глобально на весь сайт. Плагин msSezzle\Plugins\OnLoadWebDocument собирает конфиг из системных настроек, печатает window.msSezzleConfig и подключает оркестратор assets/components/mssezzle/js/web/widget.js (ставит document.sezzleConfig + грузит официальный price-widget с ?uuid=).
  • FEATURE: привязки вёрстки (targetXPath/renderToPath/стили) вынесены в настройку msszl_widget_config (JSON-массив групп) — правится под тему без вмешательства в код.
  • FEATURE: валюта берётся из настройки сайта по ключу msszl_currency_setting_key (чтобы не дублировать существующую настройку), фолбэк — msszl_currency_code (USD); подставляется в %%currency%% на сервере. Шаблон текста — настройка msszl_widget_tpl.
  • BREAKING: сниппет msSezzleWidget удалён. Вывод виджета теперь полностью на плагине и настройках — вызовы сниппета в шаблонах больше не нужны.
  • BUILD: resolver.widget.php удалён; все виджет-настройки (msszl_widget_uuid, msszl_widget_script, msszl_currency_setting_key, msszl_widget_config, msszl_widget_tpl) заводятся в БД стенда и едут в пакете штатно через transport.settings.php. Плагин привязан к событию OnLoadWebDocument (static → switch.php). transport.snippets.php теперь пустой.

1.0.3-rc

  • FIX: сниппет msSezzleWidget теперь едет в пакете как обычный (non-static) объект с зашитым кодом. Раньше он собирался как static и устанавливался без кода (пустой контент в БД, привязка к файлу не резолвилась) — на чистом сайте виджет не работал.
  • BUILD: data/transport.snippets.php собирает сниппет из файла-исходника компонента, а не из БД стенда (больше не нужно держать сниппет в категории msSezzle перед сборкой; снят принудительный static=1). resolver.widget.php теперь отвечает только за системные настройки msszl_widget_uuid/msszl_widget_script; установку/обновление/удаление самого сниппета MODX выполняет штатно по transport-объекту.

1.0.2-rc

  • FEATURE: сниппет msSezzleWidget — вывод on-site виджета Sezzle "Pay in 4" через официальный price-widget. Параметры: &amount (обяз.; 0/пусто/‹0 → пустая строка), &tpl (текст-шаблон, по умолчанию «4 interest-free payments of %%price%% with %%logo%% %%info%%»), &uuid, &script. Несколько вызовов на странице накапливают конфиг в window.msSezzleGroups; скрипт подключается один раз на DOMContentLoaded, поэтому порядок и число вызовов не важны.
  • FEATURE: системные настройки msszl_widget_uuid и msszl_widget_script (область area_msszl_widget) + строки лексикона ru/en.
  • BUILD: резолвер resolver.widget.php создаёт сниппет (static) и обе настройки при install/upgrade и удаляет при uninstall. В отличие от прочих настроек, эти НЕ нужно заводить в БД стенда перед сборкой — резолвер создаёт их на целевом сайте.

1.0.1-rc

  • Логирование переведено с файлов (logs/*.txt) на mxLogger. Logger делегирует записи сервису mxLogger (если установлен), иначе молчит и один раз предупреждает в журнале MODX. Перевод затронул msSezzle, SezzleApi, ms2-handler, PluginHandler.
  • Гейты: msszl_debug (вкл/выкл) + новая настройка msszl_log_level (минимальный уровень debug|info|warning|error, по умолчанию error; единый приёмник mxLogger, включено из коробки). Консистентно с mxLogger.min_level.
  • Тэги: базовые mssezzle + payment, этапные checkout (send), webhook (receive), auth/session/order (SezzleApi), http (ошибки запроса). Воронка processuid = «mssezzle»+md5(orderId). getResponse использует skip=2 для корректного «Источника».
  • Уровни: ошибки API/сессии — error; отмена/не захвачено/нет uuid — warning; создание сессии/redirect/capture — info; служебные запросы — debug.
  • ВНИМАНИЕ: перед сборкой настройку msszl_log_level создать в менеджере (namespace mssezzle) — сборка тянет настройки из БД стенда.

1.0.0-rc

  • Первая сборка. Компонент создан на базе mspaypalalt, адаптирован под Sezzle.

Последние обсуждения в сообществе MODX.pro