msp3YooKassa

msp3YooKassa подключает ЮKassa к MiniShop3 в MODX Revolution 3.x: REST API, сценарий redirect на оплату, входящие уведомления и по желанию чек по 54-ФЗ в одном запросе с созданием платежа.

msp3YooKassa ориентирован на MiniShop3 в MODX 3: классы оплаты, пространство имён msp3yookassa, для HTTP-уведомлений — путь …/assets/components/msp3yookassa/webhook.php.

С чего начать: Быстрый старт.

Возможности

• Одностадийная оплата — списание сразу после успешной оплаты (capture: true).
• Двухстадийная оплата — холдирование средств до подтверждения (capture) или отмены в кабинете ЮKassa / через API.
• Webhook — обновление статуса заказа в MODX по уведомлениям ЮKassa (проверка order_hash, идемпотентная обработка).
• Чеки 54-ФЗ — передача чека в запросе создания платежа (при включённой настройке и наличии email покупателя).
• Процессор Capture — подтверждение двухстадийного платежа из кода или админки (см. Интеграция).
• Ответ send() — в успешном сценарии вместе с redirect передаются order_id, order_num, msorder (UUID) и payment_id для отладки и кастомных сценариев на витрине.

Системные требования

Требование	Версия
MODX Revolution	3.0+
PHP	8.2+
MiniShop3	актуальная ветка под MODX 3
pdoTools	3.x

Зависимости

• MiniShop3 — заказы, способы оплаты, статусы (ms3_status_paid, ms3_status_canceled и т.д.).

Регистрация в ЮKassa и ключи API

Чтобы принимать оплату, нужен магазин в личном кабинете ЮKassa. После подключения в разделе настроек магазина возьмите:

• Идентификатор магазина (shopId) — в дополнении: настройка msp3yookassa_shop_id.
• Секретный ключ — в дополнении: msp3yookassa_secret_key. В старых текстах про API магазина ключ иногда называют «пароль магазина». В актуальном API ЮKassa используется пара Shop ID + Secret Key (см. формат взаимодействия с API).

Запросы к API выполняются с вашего сервера. Компонент использует официальный PHP SDK (yoomoney/yookassa-sdk-php), см. SDK ЮKassa.

У ЮKassa это же описано в коротком руководстве: создание платежа, confirmation.type = redirect, затем succeeded. У msp3YooKassa тот же порядок, детали — в интеграции.

Установка

1. Установите пакет через Управление пакетами.
2. Убедитесь, что установлен MiniShop3.
3. В Системные настройки → пространство имён msp3yookassa задайте параметры магазина (msp3yookassa_shop_id, msp3yookassa_secret_key).
4. Очистите кэш сайта.

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

Название	Класс	Поведение
Оплата через ЮKassa	Msp3YooKassa\Payment\YooKassaPayment	одностадийная
Оплата через ЮKassa (двухстадийная)	Msp3YooKassa\Payment\YooKassaTwoStagePayment	холд, затем capture

Активируйте нужный способ в MiniShop3 → Настройки → Оплаты и привяжите к сценарию оформления заказа.

Быстрая настройка webhook

В личном кабинете ЮKassa: Настройки → HTTP-уведомления укажите URL:

https://ваш-домен.ru/assets/components/msp3yookassa/webhook.php

Если URL в кабинете неверный или сервер обрывает POST, в MODX заказ может остаться неоплаченным, хотя в ЮKassa платёж уже прошёл. Подробнее: интеграция.

Документация по разделам

• Быстрый старт — установка, ключи, webhook, способ оплаты, тест, чеки.
• Системные настройки — msp3yookassa_shop_id, msp3yookassa_secret_key, чеки, URL возврата, msp3yookassa_debug.
• Интеграция и сценарии — поток оплаты, двухстадийный режим, вызов Capture, событие для позиций чека, ограничения.

Лицензия: GPLv2 и новее.