1990
24.27
28.43
за сайт
- Проверено Modstore
- Бесплатные будущие обновления
- Работа на тестовом и публичном домене
- 12 месяцев тех. поддержки
Версия
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