new

msKlarna

Оплата частями через Klarna Payments для miniShop2
Автор дополнения
Артур Шевченко
Пакетов
31
Закачек
3 662
Обычно отвечает в течение суток
Автор дополнения
Пакетов
31
Закачек
3 662
Обычно отвечает в течение суток
Версия 1.0.21-rc
Дата выпуска 20.11.2026
Загрузки 0
Внимание, этот компонент несовместим с MODX 3.
Что делает
  • Добавляет в оформление заказа оплату Klarna Payments — «купи сейчас, плати потом» и оплату частями.
  • Сессия оплаты создаётся из состава заказа miniShop2: позиции, доставка, налоги передаются как есть.
  • Итог оплаты подтверждается на стороне Klarna, статус заказа обновляется автоматически.
Особенности
  • Эндпоинты API вынесены в системные настройки и читаются для каждого контекста отдельно — в мультиязычном магазине разные регионы Klarna настраиваются независимо.
  • Переключатель тестового режима отправляет запросы в playground, не трогая боевые ключи.
  • Лексиконы переведены на 16 языков.
  • Полное логирование: в отладочный лог пишется payload запроса и использованный адрес API.
Требования
  • MODX Revolution 2.5+, PHP 7.4+
  • miniShop2
  • Merchant-аккаунт Klarna

1.0.21-rc

  • PERF: новая системная настройка msklr_osm_templates (ID шаблонов через запятую). Сниппет msKlarnaOSM выводит виджет и подгружает SDK Klarna только на этих шаблонах (карточка товара); на листинге и прочих страницах Klarna-запросов нет. Пусто — как раньше, везде. Если шаблон страницы неизвестен (AJAX-запрос без ресурса), виджет не выводится.
  • PERF: SDK Klarna OSM подключается лениво — когда первый ‹klarna-placement› подходит к viewport (IntersectionObserver, запас 200px), без него — в простое браузера. Один тег SDK на страницу, как и раньше.
  • FIX: ‹klarna-placement› получает min-height, виджет не сдвигает вёрстку при появлении (CLS).

1.0.20-rc

  • FIX: обработчики возврата клиента (msklarna.php) и уведомления Klarna (webhook.php) теперь пишут сбои в mxLogger (теги msklarna, payment, уровень error) независимо от msklr_debug: нет номера заказа, заказ не найден, заказ не оплачивается через Klarna, не загружен miniShop2 или обработчик оплаты. Раньше эти сбои уходили только в журнал ошибок MODX, и об отказе вебхука никто не узнавал. 1.0.19-rc

  • FIX: сбои оплаты теперь всегда попадают в mxLogger (теги msklarna, payment, уровень error) — независимо от настройки msklr_debug. Раньше при выключенном логировании ошибки API Klarna, невозможность создать сессию или заказ и сбои смены статуса заказа не фиксировались, и о проблеме с оплатой было не узнать. Отладочные записи (debug, info, warning) по-прежнему пишутся только при включённом msklr_debug. Если mxLogger не установлен — поведение прежнее.
  • FIX: неудачная смена статуса заказа (miniShop2 вернул не true) пишется как error с id заказа и целевым статусом; при подтверждении оплаты это возвращает ошибку вместо ложного «успеха». Пустой ответ Klarna с кодом ошибки (не 2xx) больше не принимается за успешный.
  • Отмена оплаты клиентом логируется как info, а не ошибка. В записях об ошибках токен авторизации Klarna из URL запроса скрыт.

1.0.18-rc

  • FIX: балансирующая строка sales_tax отправляется с total_tax_amount=0, а order_tax_amount=0. В 1.0.17-rc строка-надбавка несла total_tax_amount, равный своей сумме — боевая Klarna (gb/GBP) отклоняла сессию с «Bad value: order_lines[].total_tax_amount»: она валидирует строку построчно, и total_tax_amount обязан быть согласован с tax_rate (ttx = total - total*10000/(10000+rate)); строка, которая целиком налог, встроенный налог выразить не может. Итог с НДС по-прежнему авторизуется полностью — жёсткий инвариант Σ total_amount == order_amount соблюдён, налог показан отдельной строкой. Проверено реальным createSession на stage (сессия создаётся, client_token приходит).

1.0.17-rc

  • FIX: order_lines приводятся к итогу заказа (order_amount) — соблюдён инвариант Klarna Σ order_lines.total_amount == order_amount. Раньше при налоге, начисленном сверх цен позиций (increase-НДС витрины, напр. gb 20% / can 13%), initSession авторизовал доналоговую сумму: order_amount считался сырым пересчётом корзины без налога и скидок, order_tax_amount был зашит в 0, строки налог не несли. Теперь initSession берёт итог у miniShop2 (getCost — с учётом скидок/доставки/налога сайта), а SessionBuilder балансирует строки: положительная разница → строка sales_tax (и order_tax_amount), отрицательная → строка discount. Included-контексты (налог уже в цене) не меняются.

1.0.16-rc

  • FIX: из debug-лога создания сессии убраны учётные данные Klarna (username и password API). В 1.0.15-rc они писались в лог вместе с payload — при включённом уровне debug пароль магазина оседал в журнале. Остальной состав записи не изменился: baseUrl и тело запроса.

1.0.15-rc

  • LOG: в debug-лог создания сессии (createSession) пишется полный payload запроса ($data целиком) и baseUrl — видно, какой эндпоинт (live/test, регион) реально использовался. Раньше писался только order_amount.

1.0.14-rc

  • FEATURE: эндпоинты Klarna API вынесены в системные настройки msklr_endpoint_live (по умолчанию https://api.klarna.com) и msklr_endpoint_test (по умолчанию https://api.playground.klarna.com). Раньше URL были захардкожены в msKlarna::initialize(). Переключатель msklr_test_mode по-прежнему выбирает live/test. Значения читаются per-context (getOption по contextSettings) — в разных контекстах MODX можно задать разные эндпоинты, в т.ч. региональные live/playground (api-na., api-oc.). baseUrl нормализуется rtrim('/').
  • Лексикон: msklr_endpoint_live/test добавлены во все 16 языков (полный перевод). Уточнён msklr_test_mode_desc (раньше упоминал захардкоженный playground-URL).
  • ВНИМАНИЕ: перед сборкой настройки msklr_endpoint_live и msklr_endpoint_test создать в менеджере стенда (namespace msklarna) — сборка тянет настройки из БД стенда.

1.0.13-rc

  • Логирование переведено с файлов (logs/*.txt) на mxLogger. Logger делегирует записи сервису mxLogger (если установлен), иначе молчит и один раз предупреждает в журнале MODX. Перевод затронул: msKlarna, KlarnaApi, ms2-handler (msklarnahandler), PluginHandler.
  • Гейты: msklr_debug (вкл/выкл) + новая настройка msklr_log_level (минимальный уровень debug|info|warning|error, по умолчанию error; единый приёмник mxLogger, включено из коробки). Консистентно с mxLogger.min_level. PluginHandler теперь тоже учитывает msklr_debug (раньше логировал всегда).
  • Тэги: базовые msklarna + payment, этапные session / order / webhook / http. Воронка processuid = «msklarna»+md5(orderId) (send/receive) — сессия, заказ и callback одного заказа склеиваются в mxLogger одним процессом.
  • Уровни: ошибки API/cURL/JSON и пустой client_token — error; REJECTED(fraud), пустая корзина, нет auth-токена — warning; создание заказа/сессии и подтверждение — info; служебные запросы сессии — debug. getResponse использует skip=2 для корректного «Источника».
  • Лексикон: msklr_log_level добавлен во все 16 языков (ru/en — перевод, остальные — EN-лейбл).
  • ВНИМАНИЕ: перед сборкой настройку msklr_log_level создать в менеджере (namespace msklarna) — сборка тянет настройки из БД стенда.

1.0.12-rc

  • klarna.js: увеличен таймаут ожидания загрузки miniShop2 с 10 до 60 секунд.

1.0.11-rc

  • klarna.js: ошибки выводятся через miniShop2.Message.error() вместо console.error.
  • klarna.js: сообщения вынесены в лексиконы, передаются через msKlarnaConfig.lexicon.
  • klarna.js: автоматическое создание контейнера #klarna-payments-container.
  • klarna.js: корректная передача payment_method_category в Klarna.Payments.load().
  • Добавлены лексиконы для 14 языков стран Klarna (de, fr, es, it, nl, sv, da, fi, nb, pl, pt, cs, ro, el).

1.0.10-rc

  • detectContext() вынесен в msKlarna (DRY), handler использует $this-›service-›detectContext().
  • Определение контекста из куки добавлено в msKlarna.php (ранее только в handler).

1.0.9-rc

  • Добавлена настройка msklr_context_cookie_key — определение контекста MODX из куки (fallback на текущий контекст).

1.0.8-rc

  • Исправлена загрузка payment handler: заменён несуществующий miniShop2-›loadPaymentHandler() на msPayment-›loadHandler() (connector, callback, webhook).

1.0.7-rc

  • klarna.js: добавлено ожидание загрузки miniShop2 (до 10 сек) вместо молчаливого выхода.

1.0.6-rc

  • Добавлена настройка msklr_checkout_template — скрипты Klarna подключаются только на странице оформления.

1.0.5-rc

  • Исправил ошибку множественной загрузки SDK.
  • Вынес data-атрибуты в параметры сниппета.

1.0.1-rc

  • Добавил элементы в админку.

1.0.0-rc

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

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