YooMoney API
Old versions of the API
Help
Sign up for YooMoney
Setting up payment acceptance in Drupal 8/9
Using this manual, you can set up payment acceptance for your website at Drupal via YooMoney.
 
Installing the module
  1. Download the archive (.ZIP, 25 KB).
  2. Open the website's dashboard. Click "Main — Maintenance — Add-on". Select "Install new module".
  3. Upload the archive with the new module and click "Install". As soon as the installation process is complete, the add-on will be dispalyed in the list. Make sure to tick the box next to YooKassa Module.
  4. Click Save the settings and wait for the Settings saved message. That's it: the module has been installed and activated.
How to switch to Russian
  1. Click the Management tab in the upper menu to open the website's dahsboard. Select Configuration.
  2. Find the Region and language block. Select the last item, User interface translation.
  3. View the Import tab.
  4. This is the dashboard for importing files containing translations. Upload the PO-format file for translating the YooMoney module from the archive containing the module. Click Overview, find the file on your HDD, and click Import.
    After that, the module's interface will be translated to Russian.
Setting up payment acceptance via YooMoney
Для последних версий модуля (начиная с 2.3.0)
  1. Введите любое название платёжного шлюза и выберите плагин YooКassa
  2. Если магазин к модулю ещё не подключен, нажмите на Подключить магазин.
    Если магазин подключен и вы хотите его поменять, нажмите Сменить магазин.
  3. Откроется всплывающее окно. Если не открылось, возможно, браузер его заблокировал — разрешите открывать всплывающие окна на этом сайте.
  4. Разрешите выдать доступ к ЮKassa.
  5. Выберите магазин, который хотите подключить к модулю.
  6. Введите код из смс → всплывающее окно закроется и появятся данные по подключенному магазину. Если вышла ошибка, перезагрузите страницу и начните заново.
Для более поздних версий модуля (2.2.8 и старше)
  1. Для подключения магазина к модулю вам нужны параметры:
    • shopId will appear in your Merchant Profile by itself when you sign up for the service,
    • cекретный ключ — нужно выпустить в личном кабинете ЮKassa в разделе Интеграция → Ключи API → Секретный ключ.
  2. Заполните поля shopID и Секретный ключ.
  3. Нажмите «Сохранить конфигурацию».
Setting up payment acceptance
  1. Click the Management tab in the upper menu to open the website's dashboard. Select Trading.
  2. Select «Configuration».
  3. Find the Payment block on the opened page and follow the Payment gateways link.
  4. Find the line with the YooMoney payment gateway and click Edit to access the settings.
  5. This is the YooMoney settings page. All YooMoney module's settings in Drupal 8.x are configured on this page.
    Specify the shopId and Secret key that you received during onboarding with YooMoney.
    • shopId will appear in your Merchant Profile by itself when you sign up for the service,
    • Secret key is issued independently and requires activation in Merchant Profile. More in YooMoney's help guide
    You can also enable the transmission of receipt data and specify the VAT rates if you're using the YooMoney solution in accordance with Federal Law No. 54-FZ
Настройки для отправки второго чека по 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. Сохраните настройки