docs.modx.pro
msp3YooKassa
msp3YooKassa
Приём оплаты через ЮKassa для MiniShop3 — одно- и двухстадийные платежи, webhook, чеки 54-ФЗ
  • MODX 3
  • PHP 8.2
  • miniShop3
Зависимости
  • miniShop3
  1. Компоненты
  2. msp3YooKassa
  3. Быстрый старт

Быстрый старт ​

Как включить приём оплаты через ЮKassa на сайте с MiniShop3.

Требования ​

ТребованиеВерсия
MODX Revolution3.0+
PHP8.2+
MiniShop3установлен
pdoTools3.x
Аккаунт ЮKassaЛичный кабинет. Для проверки без боевых денег — тестовый магазин (отдельные shop_id и ключ с префиксом test_), см. тестовую среду и тестовые карты

Шаг 1: Установка пакета ​

  1. Убедитесь, что установлен MiniShop3.
  2. Перейдите в Управление пакетами (Extras → Installer).
  3. Установите msp3YooKassa (загрузка с ModStore).
  4. Управление → Очистить кэш.

После установки должен появиться плагин msp3yookassa_bootstrap (событие OnMODXInit): он подключает автозагрузку классов оплаты. Убедитесь, что плагин не отключён.

Шаг 2: Ключи магазина в MODX ​

  1. Настройки → Системные настройки, фильтр по пространству имён msp3yookassa.
  2. Заполните:
    • msp3yookassa_shop_id — идентификатор магазина из кабинета ЮKassa.
    • msp3yookassa_secret_key — секретный ключ (для теста — ключ с префиксом test_).

Подробнее: Системные настройки.

Шаг 3: HTTP-уведомления в ЮKassa ​

Без этого шага заказ в MODX не перейдёт в «оплачен» автоматически после успешной оплаты.

  1. Войдите в личный кабинет ЮKassa.
  2. Откройте настройки HTTP-уведомлений (интеграция / уведомления — см. документацию).
  3. Укажите URL с вашим доменом и HTTPS (только путь msp3YooKassa ниже):
text
https://ваш-домен.ru/assets/components/msp3yookassa/webhook.php

Шаг 4: Способ оплаты в MiniShop3 ​

Резолвер пакета создаёт два способа (если их ещё не было):

СпособКогда использовать
Оплата через ЮKassaобычная продажа — списание сразу
Оплата через ЮKassa (двухстадийная)холд → подтверждение через процессор Capture
  1. В админке MiniShop3 откройте Настройки → Оплаты (или эквивалент в вашей сборке MS3).
  2. Включите (Активен) нужный способ и при необходимости отключите лишний.
  3. Убедитесь, что на странице оформления заказа этот способ доступен покупателю (связь с доставками / шаблон заказа — по правилам вашего магазина).

Шаг 5: Проверка оплаты ​

  1. Оформите тестовый заказ на сумму не меньше 0,01 ₽.
  2. Выберите ЮKassa и перейдите к оплате — откроется страница ЮKassa (редирект).
  3. При тестовых ключах платите тестовой картой. Боевые карты в тестовом магазине не проходят — так задано в правилах ЮKassa.
  4. После успеха в MODX у заказа должен выставиться статус из ms3_status_paid (часто это ID 3 — проверьте в настройках MiniShop3).

Статус не сменился — чаще всего не доходит webhook (URL, HTTPS, фаервол) или в MODX указаны не те ключи.

Шаг 6: Чеки 54-ФЗ (опционально) ​

Если нужно передавать данные чека в запрос создания платежа:

  1. Включите msp3yookassa_payment_receipt = «Да».
  2. Укажите msp3yookassa_vat_code (коды 1–10 — см. таблицу в настройках).
  3. Убедитесь, что у заказа есть email покупателя (properties.email заказа или email профиля пользователя).

В тестовом магазине в кабинете можно включить проверку чеков: касса и ОФД имитируются, на руки чек не уйдёт — так и задумано для отладки. Перед приёмом реальных платежей сверьте настройки кассы уже в рабочем магазине.

Без email в заказе чек в запрос не подставится. Детали: настройки, интеграция.

Что дальше ​