Системные настройки msp3YooKassa

Краткая последовательность шагов: Быстрый старт.

Все настройки в пространстве имён msp3yookassa. Ключ в modSystemSetting (и в getOption()) — с подчёркиванием: msp3yookassa_shop_id, msp3yookassa_secret_key и т.д. Раньше встречались имена с точкой (msp3yookassa.shop_id). При обновлении пакета резолвер переносит значения на новые ключи. Ниже — актуальные имена.

Обязательные

Ключ	Тип	Описание
msp3yookassa_shop_id	текст	Идентификатор магазина (shopId) из личного кабинета ЮKassa. Для тестового магазина — тестовый идентификатор из кабинета.
msp3yookassa_secret_key	пароль	Секретный ключ API (в старых материалах к API магазина иногда пишут «пароль магазина»). Для теста — ключ с префиксом test_.

Без пары msp3yookassa_shop_id + msp3yookassa_secret_key создание платежа завершается ошибкой «Payment is not configured». Способ передачи ключей в HTTP-запросах к API описан в документации ЮKassa.

Оплата и возврат покупателя

Ключ	Тип	Описание
msp3yookassa_success_url	URL	Куда направить пользователя после успешной оплаты. Пусто — используется страница благодарности MiniShop3 (ms3_order_redirect_thanks_id) с параметром msorder=<uuid>.
msp3yookassa_fail_url	URL	Страница при неуспешной оплате. Пусто — снова страница благодарности с параметром payment_fail=1.

Фискализация (54-ФЗ)

Ключ	Тип	Описание
msp3yookassa_payment_receipt	да/нет	Включить передачу объекта receipt в createPayment.
msp3yookassa_vat_code	список	Код НДС по справочнику ЮKassa для чеков (коды 1–10, см. основы чеков).

Коды НДС (vat_code):

Код	Значение
1	Без НДС
2	НДС по ставке 0%
3	НДС по ставке 10%
4	НДС по ставке 20%
5	НДС по расчётной ставке 10/110
6	НДС по расчётной ставке 20/120
7	НДС по ставке 5%
8	НДС по ставке 7%
9	НДС по расчётной ставке 5/105
10	НДС по расчётной ставке 7/107

Чек соберётся только если у покупателя есть email — в properties.email заказа или в профиле (modUserProfile.email). Иначе блок receipt в запрос не уходит.

Служебные

Ключ	Тип	Описание
msp3yookassa_debug	да/нет	Писать служебные сообщения компонента в лог MODX (LOG_LEVEL_DEBUG).

Связанные настройки MiniShop3

Поведение после оплаты завязано на системные настройки ms3, в частности:

• ms3_status_paid — статус «оплачен» (по умолчанию часто 3), выставляется webhook’ом при succeeded и процессором Capture после успешного списания.
• ms3_status_canceled — статус отмены (часто 5), выставляется при canceled в webhook.
• ms3_order_redirect_thanks_id — ID ресурса «Спасибо за заказ», если не заданы собственные success_url / fail_url.

Проверьте значения в Системные настройки → minishop3 или в настройках MiniShop3 в админке.