Docs
API ЮKassa
Старые версии API
Помощь
Подключить ЮKassa

Настройка модуля ЮKassa для сайта на MODX

Как установить модуль
  1. Скачайте архив с модулем
  2. В панели управления сайтом нажмите Приложения → Установщик. Откроется страница со списком пакетов.
  3. Нажмите Загрузить дополнения → Загрузить пакет.
  4. Загрузите архив с модулем: нажмите Выбрать пакет → Загрузить.
  5. Когда архив загрузится, закройте окно загрузки. На странице со списком пакетов найдите YooMoney и нажмите Установить → Опции установки → Установить пакет.
  6. Откройте чанк формы оплаты и в списке способов оплаты укажите [[!YooMoney?&action=showMethods]]. Это выглядит так:
    <select name="payment" style="width:200px;">
    <option value="При получении" [[!+fi.payment:FormItIsSelected=`При получении`]]>При получении</option>
    [[!YooMoney? &action=`showMethods` ]]
    </select>
    
  7. Откройте чанк страницы оформления заказа и в список хуков FormIt добавьте YooMoneyHook, Это выглядит так:
    [[!FormIt?
    &hooks=`spam,shk_fihook,YooMoneyHook,email,FormItAutoResponder,redirect`
    &submitVar=`order`
    &emailTpl=`shopOrderReport`
    &fiarTpl=`shopOrderReport`
    &emailSubject=`В интернет-магазине «[[++site_name]]» сделан новый заказ`
    &fiarSubject=`Вы сделали заказ в интернет-магазине "[[++site_name]]"`
    &emailTo=`[[++emailsender]]`
    &redirectTo=`25`
    &validate=`address:required,fullname:required,email:email:required,phone:required`
    &errTpl=`<br /><span class="error«>[[+error]]</span>`
    ]]
    
  8. Создайте страницу успешного платежа и страницу ошибки платежа.
    После этого можно настраивать приём платежей через ЮKassa.
Как включить приём платежей через ЮKassa
Чтобы настроить приём платежей, сначала нужно подключиться к ЮKassa и получить ShopID и Секретный ключ.
  • ShopID появится в личном кабинете ЮKassa, когда вы подключитесь к сервису
  • Cекретный ключ нужно самостоятельно выпустить и активировать в личном кабинете ЮKassa
Настройка модуля
  1. Откройте панель управления сайтом и в меню слева выберите Элементы → Сниппеты → YooMoney.
  2. Выберите вкладку Параметры и нажмите Параметры по умолчанию заблокированы — эта кнопка разблокирует настройки модуля, и вы сможете их редактировать.
  3. Заполните настройки модуля как в таблице ниже.

    Чтобы отредактировать любое поле, кликните два раза по значению в самом правом столбике.

    accountНе меняйте
    fail_page_idУкажите ID страницы, которую нужно показывать пользователю, если его платёж завершился ошибкой
    method_cardsПоставьте Да, если в договоре с ЮKassa есть способ оплаты Банковские карты
    method_cashПоставьте Да, если в договоре с ЮKassa есть способ оплаты Наличные
    method_sbОставьте Да, если в договоре с ЮKassa есть способ оплаты SberPay
    method_ymПоставьте Да, если в договоре с ЮKassa есть способ оплаты кошелёк ЮMoney
    passwordУкажите в поле параметр Секретный ключ — его нужно выпустить и активировать в личном кабинете ЮKassa
    shopidУкажите в поле параметр ShopID — его можно скопировать в личном кабинете ЮKassa
    success_page_idУкажите ID страницы, которую нужно показывать пользователю, если его платёж прошёл успешно
    tax_id
    Если вы фискализируете платежи с помощью решения ЮKassa, справа выберите свою налоговую ставку.
    Если вы фискализируете платежи без участия ЮKassa, оставьте поле без изменений. Подробнее о решении ЮKassa для 54-ФЗ
    yookassa_send_checkПоставьте Да, если проводите фискализацию с помощью решения ЮKassa. Подробнее о решении ЮKassa для 54-ФЗ
  4. Сохраните настройки. Готово, можно проверять приём платежей.
© 2025, ООО НКО «ЮМани»