API ЮKassa
Помощь
Подключить ЮKassa
ЮKassa для MODX Revolution
Инструкция по настройке
Модуль работает с двумя платёжными сервисами ЮMoney.
ЮKassa
Через ЮKassa можно включить прием платежей на сайте. Доступны все популярные способы: банковские карты, электронные кошельки, наличные, интернет-банки, баланс мобильного и другие.
Это сервис для бизнеса: для работы с ним нужен договор, деньги будут поступать на расчетный счёт компании.
ЮMoney
Через ЮMoney можно включить на сайте приём платежей с банковских карт и из электронных кошельков. ЮMoney будут приходить в кошелёк ЮMoney, договор не нужен.
Как установить модуль
  1. В панели управления сайтом последовательно нажмите Приложения — Установщик. Откроется страница со списком пакетов.
  2. Нажмите Загрузить дополнения — Загрузить пакет.
  3. Загрузите архив с модулем (Выбрать пакет — Загрузить).
  4. Когда будет готово, закройте окно загрузки. На странице со списком пакетов найдите YooMoney и нажмите Установить — Опции установки — Установить пакет.
  5. Откройте чанк формы оплаты и в списке способов оплаты укажите [[!YooMoney?&action=showMethods]]. Это выглядит так:
    <select name="payment" style="width:200px;">
    <option value="При получении" [[!+fi.payment:FormItIsSelected=`При получении`]]>При получении</option>
    [[!YooMoney? &action=`showMethods` ]]
    </select>
  6. Откройте чанк страницы оформления заказа и в список хуков 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>`
    ]]
  7. Создайте страницу успешного платежа и страницу ошибки платежа.
    После этого можно настраивать прием платежей одним из двух способов:
    • через ЮKassa,
    • через ЮMoney,
Как включить прием платежей через ЮKassa
Чтобы настроить прием платежей по этой инструкции, нужно Подключиться к ЮKassa и получить параметры shopId и Секретный ключ.
  • shopId появится в личном кабинете ЮKassa сам, когда вы подключитесь к сервису,
  • секретный ключ нужно самостоятельно выпустить и активировать в личном кабинете ЮKassa.
Когда у вас будут оба этих параметра, можно переходить к настройке модуля по этой инструкции.
  1. Откройте панель управления сайтом и в меню слева выберите YooMoney (вкладка Элементы, раздел Сниппеты).
  2. Выберите вкладку Параметры и нажмите Параметры по умолчанию заблокированы — эта кнопка разблокирует настройки модуля, и вы сможете их редактировать.
  3. Заполните настройки модуля как в таблице ниже.
    accountНе меняйте
    fail_page_idУкажите ID страницы, которую нужно показывать пользователю, если его платёж завершился ошибкой
    method_cardsПоставьте Да, если в договоре с ЮKassa есть способ оплаты Банковские карты
    method_cashПоставьте Да, если в договоре с ЮKassa есть способ оплаты Наличные
    method_qwПоставьте Да, если в договоре с ЮKassa есть способ оплаты Qiwi
    method_sbОставьте Да, если в договоре с ЮKassa есть способ оплаты SberPay
    method_ymПоставьте Да, если в договоре с ЮKassa есть способ оплаты кошелёк ЮMoney
    mode
    Поставьте Юридическое лицо (выбор способа оплаты на стороне магазина), если хотите, чтобы все способы оплаты были размещены на вашем сайте.
    Поставьте Юридическое лицо (выбор способа оплаты на стороне ЮKassa), если хотите, чтобы все способы оплаты были размещены на стороне ЮKassa.
    passwordУкажите в поле параметр Секретный ключ — его нужно выпустить и активировать в личном кабинете ЮKassa
    shopidУкажите в поле параметр shopId — его можно скопировать в личном кабинете ЮKassa
    success_page_idУкажите ID страницы, которую нужно показывать пользователю, если его платёж прошёл успешно
    tax_id
    Если вы фискализируете платежи с помощью решения ЮKassa, справа выберите свою налоговую ставку.
    Если вы фискализируете платежи без участия ЮKassa, оставьте поле без изменений. Подробнее о решении ЮKassa для 54-ФЗ
    yookassa_send_checkПоставьте Да, если проводите фискализацию с помощью решения ЮKassa. Подробнее о решении ЮKassa для 54-ФЗ
  4. Сохраните настройки. Готово, можно проверять приём платежей.
Как настроить прием платежей в кошелёк ЮMoney
Чтобы настроить приём платежей по этой инструкции, нужен номер кошелька ЮMoney. Создать кошелёк
  1. Откройте панель управления сайтом и в меню слева выберите YooMoney (вкладка Элементы, раздел Сниппеты).
  2. Выберите вкладку Параметры и нажмите Параметры по умолчанию заблокированы — эта кнопка разблокирует настройки модуля, и вы сможете их редактировать.
  3. Заполните настройки модуля как в таблице ниже.
    accountУкажите номер кошелька, в который нужно отправлять деньги
    fail_page_idНе меняйте
    method_abНе меняйте
    method_cardsПоставьте Да, если хотите принимать платежи с банковских карт
    method_cashНе меняйте
    method_qwНе меняйте
    method_sbНе меняйте
    method_wmНе меняйте
    method_ymПоставьте Да, если хотите принимать платежи из кошельков ЮMoney
    modeПоставьте Физическое лицо
    passwordВ настройках кошелька выпустите Секретное слово и скопируйте его сюда Выпустить секретное слово
    shopidНе меняйте
    success_page_idУкажите ID страницы, которую нужно показывать пользователю, если его платёж прошёл успешно
    tax_idНе меняйте
    yookassa_send_checkНе меняйте
  4. Сохраните настройки. Готово, можно проверять приём платежей.