ЮKassa — платёжный сервис для приёма онлайн-оплаты банковскими картами, через СБП и другими способами, которые входят в ваш договор с ЮKassa. Подключение: «Настройки магазина» → вкладка «Платежи» → «Добавить» → «Оплата через ЮKassa». Ниже — где взять Shop ID и секретный ключ, как настроить уведомления об оплате и заполнить форму.
Онлайн-кассу по 54-ФЗ применяет продавец, кроме случаев, когда закон от неё освобождает: например, самозанятые выдают чек через приложение «Мой налог». Если в ЮKassa подключено формирование чеков, отдельная касса не нужна: BOTFARM передаёт в ЮKassa позиции заказа, а чек формирует и отправляет покупателю сама ЮKassa. С каждой операции ЮKassa удерживает комиссию по своему тарифу; на октябрь 2026 ставка зависит от способа оплаты и договора — сверьте её в личном кабинете ЮKassa.
Добавление платёжной системы
Нажмите «Добавить» в блоке «Способы оплаты» на вкладке «Платежи» — откроется окно выбора способа оплаты. Если Shop ID и секретного ключа ЮKassa ещё нет, сначала получите их — порядок описан ниже в разделе «Получение данных в ЮKassa».
Выбор добавляемой оплаты
Выберите в окне пункт «Оплата через ЮKassa» — откроется форма с тремя обязательными полями.
Прежде чем заполнять форму «Оплата через ЮKassa», зарегистрируйтесь в ЮKassa и получите Shop ID и секретный ключ: без них форму не сохранить.
Получение данных в ЮKassa
Shop ID и секретный ключ выдаёт ЮKassa в своём личном кабинете, а не панель BOTFARM. Порядок регистрации ниже описан по сайту ЮKassa на октябрь 2026; названия разделов могут меняться — сверьте их в личном кабинете ЮKassa.
Зарегистрируйтесь на сайте ЮKassa
- Перейдите на официальный сайт: https://yookassa.ru/
- Для входа потребуется учётная запись на Яндексе (почта @yandex.ru или @ya.ru).
- Подготовьте ИНН — юридического лица, ИП или самозанятого.
⚠️ Важное примечание для самозанятых:
Самозанятому сначала нужно подать на сайте ЮKassa отдельную заявку на подключение: без предварительного согласования обычная учётная запись самозанятого не подойдёт. Условия на текущую дату уточните в поддержке ЮKassa.
Добавьте магазин в личном кабинете
Создайте в личном кабинете ЮKassa новый магазин — Shop ID появится только после его подключения:
- Найдите кнопку или раздел для создания магазина (обычно «Подключить магазин» или «Создать магазин»).
- Укажите название магазина, сайт и виды деятельности.
- Пройдите проверки ЮKassa: сервис может запросить документы.
Найдите Shop ID (идентификатор магазина)
Скопируйте Shop ID в разделе «Настройки» → «Магазин» (или просто «Магазин») личного кабинета ЮKassa. Shop ID — номер вашего магазина в ЮKassa; он появляется после подключения магазина.
Где его посмотреть:
- Зайдите в личный кабинет ЮKassa.
- Перейдите в раздел «Настройки» → «Магазин» (или просто «Магазин»).
- Найдите поле Shop ID — это число, например 123456.
📌 Сохраните Shop ID: он понадобится в форме «Оплата через ЮKassa».
Выпустите секретный ключ (без него оплата не подключится)
Выпустите секретный ключ в разделе «Интеграция» → «Ключи API» личного кабинета ЮKassa. Секретный ключ — код, которым магазин подтверждает ЮKassa, что запрос на оплату отправил именно он.
Как получить ключ:
-
В личном кабинете ЮKassa перейдите в раздел «Интеграция» → «Ключи API».
-
Нажмите кнопку «Выпустить новый ключ».
-
ЮKassa покажет длинную строку из букв и цифр — это и есть секретный ключ.
⚠️ Важно: сразу скопируйте ключ и сохраните его в надёжном месте, например в хранилище паролей или в зашифрованном документе.
🔐 ЮKassa показывает секретный ключ только один раз. Если ключ потерян, выпустите новый — старый перестанет работать, и его придётся заменить в форме магазина.
Настройте HTTP-уведомление в личном кабинете ЮKassa
Добавьте адрес для уведомлений в разделе «Интеграция» → «HTTP-уведомления» личного кабинета ЮKassa — шаг обязателен. HTTP-уведомление (вебхук) — сообщение, которое ЮKassa сама отправляет на сервер магазина, когда меняется статус платежа; по нему заказ автоматически получает статус «Оплачен».
Адрес для уведомлений (URL) строится из домена вашего магазина и служебного пути /api/v2/yookassa/webhook.
Например, если магазин открыт по адресу:
https://myshop.ruто адрес для HTTP-уведомлений будет:
https://myshop.ru/api/v2/yookassa/webhookЕсли у магазина подключён свой домен, подставьте его вместо https://myshop.ru. Укажите домен магазина с https://, без косой черты в конце, и добавьте путь /api/v2/yookassa/webhook.
Выберите для уведомления события:
payment.succeeded— успешная оплата;payment.canceled— отмена или неуспешная оплата.
⚠️ Важно: без HTTP-уведомления магазин узнаёт об оплате только при повторном запросе статуса платежа, а этот запрос срабатывает, когда покупатель возвращается на страницу заказа. Если покупатель закроет страницу ЮKassa, заказ может остаться в ожидании оплаты, хотя платёж уже прошёл.
Заполнение формы в панели управления магазином
Заполните три обязательных поля формы «Оплата через ЮKassa», когда Shop ID и секретный ключ уже получены:
- Название способа оплаты (обязательное поле).
Это название покупатели увидят при выборе способа оплаты в корзине и при оформлении заказа. - Shop ID (обязательное поле).
Вставьте идентификатор магазина из личного кабинета ЮKassa. - Секретный ключ (обязательное поле).
Вставьте секретный ключ, выпущенный в личном кабинете ЮKassa.
Завершение: сохранение и добавление способа оплаты
Нажмите «Добавить» внизу формы — способ оплаты сохранится и появится в списке магазина. Кнопка становится активной, когда заполнены все обязательные поля.
«Назад» — возвращает к выбору способа оплаты; введённые данные не сохранятся.
«Добавить» — сохраняет способ оплаты и добавляет его к магазину.
Что должно получиться
В списке способов оплаты появится строка с введённым названием и значком ЮKassa. Как этот способ выглядит рядом с остальными, описано в статье Способы оплаты.
Короткие ответы
Нужна ли онлайн-касса, если принимать оплату через ЮKassa?
Нет, если в ЮKassa подключено формирование чеков: чек по 54-ФЗ формирует и отправляет покупателю сама ЮKassa по позициям, которые передаёт BOTFARM. Самозанятые кассу не применяют и выдают чек через приложение «Мой налог».
Почему заказ, оплаченный через ЮKassa, не стал «Оплачен»?
Чаще всего не настроено HTTP-уведомление в личном кабинете ЮKassa. Добавьте адрес вида https://домен-магазина/api/v2/yookassa/webhook и события payment.succeeded и payment.canceled.
Можно ли оплатить через ЮKassa без почты и телефона покупателя?
Нет. Для онлайн-оплаты через ЮKassa покупатель указывает адрес электронной почты или телефон: на один из них ЮKassa отправляет чек, и без них ссылка на оплату не создаётся.
Что делать, если секретный ключ ЮKassa потерян?
Выпустите новый ключ в разделе «Интеграция» → «Ключи API» личного кабинета ЮKassa и вставьте его в форму способа оплаты. Повторно посмотреть старый ключ нельзя.
Сколько стоит приём оплаты через ЮKassa?
Комиссию ЮKassa удерживает с каждой операции по своему тарифу. На октябрь 2026 ставка зависит от способа оплаты и договора — сверьте её в личном кабинете ЮKassa.