API ЮKassa
Помощь
Подключить ЮKassa
Инструкция для JoomShopping на базе CMS Joomla
Как установить модуль
  1. Скачайте архив с модулем (.zip, 977 Кб).
  2. В панели управления сайтом нажмите Компоненты — JoomShopping — Установка и обновление (Install & Update).
  3. На открывшейся странице выберите архив, который скачали, и нажмите Загрузить.
  4. Когда сверху появится сообщение «Завершено», можно переходить к настройке.
Как подключить магазин к модулю
Для последних версий модуля (начиная с 2.5.0)
  1. Подключите ЮKassa
  2. В панеле управления сайтом зайдите в раздел Система → Плагины.
  3. Введите в поиске «http», найдётся плагин «Система - HTTP Headers» — кликните по нему.
  4. Запомните или запишите значения, которые выставлены в строках Referrer-Policy и Cross-Origin-Opener-Policy, сейчас надо изменить их на «Отключено», но чуть позже нужно будет вернуть настройки обратно. Сохраните настройки.
  5. В панели управления сайтом нажмите Компоненты — JoomShopping — Options.
  6. На открывшейся странице нажмите Способы оплаты, затем — ЮMoney.
  7. Выберите вкладку Главный, затем укажите название на русском (ЮKassa) и английском (YooKassa).
  8. Выберите вкладку Конфигурация, затем — вкладку ЮKassa.
  9. Если магазин к модулю ещё не подключен, нажмите на Подключить магазин.
    Если магазин подключен и вы хотите его поменять, нажмите Сменить магазин.
  10. Откроется всплывающее окно. Если не открылось, возможно, браузер его заблокировал — разрешите открывать всплывающие окна на этом сайте.
  11. Разрешите выдать доступ к ЮKassa.
  12. Выберите магазин, который хотите подключить к модулю.
  13. Введите код из смс → всплывающее окно закроется, появятся данные по подключенному магазину.
    Если вышла ошибка, перезагрузите страницу и начните заново.
  14. Снова зайдите в раздел Система → Плагины.
  15. Введите в поиске «http», найдётся плагин «Система - HTTP Headers» — кликните по нему.
  16. В строках Referrer-Policy и Cross-Origin-Opener-Policy выставите изначальные значения (из пункта 4 этой инструкции) и сохраните настройки.
  17. Если после смены или подключения магазина перестали приходить уведомления об изменении статуса платежа — проблема может быть в адресе для уведомлений. Измените адрес уведомлений на нужный и сохраните настройки. Если не получилось, свяжитесь с техподдержкой.
Для более поздних версий модуля (2.4.0 и старше)
  1. Подключите ЮKassa
  2. Для подключения магазина к модулю вам нужны параметры:
    • shopid — появится в личном кабинете ЮKassa сразу после подключения,
    • cекретный ключ — нужно выпустить в личном кабинете ЮKassa в разделе Интеграция → Ключи API → Секретный ключ.
  3. Заполните поля shopid и cекретный ключ.
  4. Нажмите «Сохранить конфигурацию».
Как настроить приём платежей
  1. Поставьте галочку Включить приём платежей через ЮKassa:
  2. Отметьте, где клиент должен выбирать способ оплаты — на стороне ЮKassa или на вашем сайте.
  3. Если вы выбрали сценарий оплаты «на стороне магазина», отметьте галочками способы оплаты, которые указаны в вашем договоре с ЮMoney.
  4. Если вы настраивали отправку чеков в налоговую через партнёров ЮKassa (по 54-ФЗ), включите отправку данных для чека.
    Укажите, какую ставку НДС ставить в чеке:
    • ставка по умолчанию будет в чеке для товаров, у которых вы не указывали НДС раньше,
    • ставки, которые уже есть в вашем магазине, нужно сопоставить со ставками в ЮKassa.
      Когда вы настроили всё для 54-ФЗ, можно включить опцию «Второй чек». Модуль будет автоматически формировать закрывающий чек, если в заказе есть позиции с полной предоплатой, и этот заказ перешёл в выбранный статус. Например, «Доставлен».
  5. В выпадающем списке выберите статус, который будет присвоен заказу после оплаты.
  6. Нажмите Сохранить наверху страницы. Готово: можно проверять приём платежей через ЮKassa.