API ЮKassa
Помощь
Подключить ЮKassa
Настройка приёма платежей в Drupal 8/9
По этой инструкции можно настроить приём платежей для сайта на Drupal через ЮKassa.
Установка модуля
  1. Откройте управление сайтом. Нажмите «Главная — Администрирование — Расширение». Выберите «Установить новый модуль».
  2. Загрузите архив с модулем и нажмите «Установить». Как только установка закончится, расширение отобразится в списке. Убедитесь, что рядом с YooKassa Module стоит галочка.
  3. Нажмите Сохранить настройки и дождитесь надписи Настройки сохранены. Готово — модуль установлен и активирован.
Как включить русский язык
  1. Нажмите вкладку Управление в верхнем меню, откроется панель управления сайтом. Там выберите пункт Конфигурация.
  2. На открывшейся странице найдите блок Регион и язык. Выберите последний пункт — User interface translation.
  3. Перейдите на вкладку Импортировать.
  4. Перед вами панель для импорта файлов, содержащих переводы. Сюда нужно загрузить файл перевода модуля ЮKassa — это файл с расширением .po из архива с модулем. Нажмите Обзор, выберите этот файл у себя на диске и нажмите Импортировать.
    После этого интерфейс модуля будет переведён на русский язык.
Свяжите ваш сайт на Drupal с личным кабинетом ЮKassa
Для последних версий модуля (начиная с 2.3.0)
  1. Введите любое название платёжного шлюза и выберите плагин YooКassa
  2. Если магазин к модулю ещё не подключен, нажмите на Подключить магазин.
    Если магазин подключен и вы хотите его поменять, нажмите Сменить магазин.
  3. Откроется всплывающее окно. Если не открылось, возможно, браузер его заблокировал — разрешите открывать всплывающие окна на этом сайте.
  4. Разрешите выдать доступ к ЮKassa.
  5. Выберите магазин, который хотите подключить к модулю.
  6. Введите код из смс → всплывающее окно закроется и появятся данные по подключенному магазину. Если вышла ошибка, перезагрузите страницу и начните заново.
Для более поздних версий модуля (2.2.8 и старше)
  1. Для подключения магазина к модулю вам нужны параметры:
    • shopID — появится в личном кабинете ЮKassa сразу после подключения,
    • cекретный ключ — нужно выпустить в личном кабинете ЮKassa в разделе Интеграция → Ключи API → Секретный ключ.
  2. Заполните поля shopID и Секретный ключ.
  3. Нажмите «Сохранить конфигурацию».
Настройте приём платежей
  1. Нажмите вкладку Управление в верхнем меню, откроется панель управления сайтом. Там выберите пункт Торговля.
  2. Выберите пункт «Конфигурация».
  3. На открывшейся странице найдите блок Оплата и перейдите по ссылке Платёжные шлюзы.
  4. Найдите строку с платёжным шлюзом YooKassa и нажмите Редактировать, чтобы перейти в настройки.
  5. Перед вами страница настроек YooKassa. В Drupal 8.x все настройки модуля ЮKassa происходят на этой странице.
    Здесь нужно указать ваш shopId и Секретный ключ, которые вы получили при подключении к ЮKassa.
    • shopId появится в личном кабинете ЮKassa сам, когда вы подключитесь к сервису,
    • секретный ключ нужно самостоятельно выпустить и активировать в личном кабинете ЮKassa. Подробнее в Помощи ЮKassa
      Также здесь можно включить отправку данных для чека и указать ставки НДС, если вы используете решение ЮKassa по 54-ФЗ.
Настройки для отправки второго чека по 54-ФЗ
  1. В панели администратора Drupal перейдите на вкладку Расширения, поставьте галочку рядом с YooKassa Module и нажмите Установить
  2. Перейдите в раздел Торговля → Конфигурация → Типы заказов
  3. Найдите тип заказа с названием default и нажмите на Редактировать. Если такого типа заказа нет — нажмите на Добавить тип заказа
  4. В поле Метка напишите default
  5. В поле Порядок действий выберите Yookassa order statuses или используйте другой порядок, который подходит вашему магазину. В зависимости от порядка действий устанавливаются разные статусы заказов:
    • Default: черновик, выполнен, отменён
    • Yookassa order statuses: черновик, ожидание оплаты или ожидание подтверждения, оплачен, выполнен, отменён
    • Default with validation: черновик, на утверждении, выполнен, отменён
    • Fulfillment: черновик, выполняется, выполнен, отменён
    • Fulfillment with validation: черновик, на утверждении, выполняется, выполнен, отменён
  6. Сохраните настройки
  7. Перейдите в раздел Торговля → Конфигурация → Типы позиций заказа
  8. Найдите тип позиции заказа с названием default и нажмите на Редактировать. Если такого типа позиции нет — нажмите на Добавить тип позиций заказа
  9. В поле Метка напишите default
  10. В поле Тип заказа выберите тот, который указан в разделе Типы заказов. Если вы настраивайте модуль по этой инструкции — выбирайте default
  11. Сохраните настройки
  12. Перейдите в раздел Торговля → Конфигурация → Платёжные шлюзы
  13. Найдите платёжный шлюз с названием default и нажмите на Редактировать. Если такого платёжного шлюза нет — нажмите на Добавить тип заказа
  14. В поле Название напишите yookassa
  15. В поле Плагин выберите YooKassa
  16. Secret Key и shopId скопируйте из Личного кабинета ЮKassa
  17. Поставьте галочку на Отправлять в ЮKassa данные для чеков (54-ФЗ) — появятся новые поля, которые нужно заполнить. Если не появился раздел Сопоставьте ставки, создайте и настройте налоговые ставки в разделе Торговля → Конфигурация → Виды налогов
  18. Заполните поля Система налогообложения, Предмет расчёта и Способ расчёта
  19. Поставьте галочку на Отправлять второй чек → появятся новые поля.
  20. В поле Тип заказа, используемый на сайте выберите тот, который указан в разделе Типы заказов. Если вы настраивайте модуль по этой инструкции, выбирайте default
  21. В поле Отправлять второй чек при переходе заказа в статус выберите статус, после которого чек будет отправляться
  22. Сохраните настройки