Как подключить ЮKassa к сайту и боту

Ты собрал приложение, оно решает реальную задачу, и первые пользователи спрашивают: «А как заплатить?». Без нормального приёма платежей проект остаётся хобби. В России одно из самых доступных решений для сайта или бота — ЮKassa. Мы сами прошли этот путь: подключали ЮKassa к своему сайту, настраивали API, вебхуки и чеки, проходили модерацию и переводили магазин в боевой режим. Ниже расскажем, как подключить ЮKassa к сайту пошагово, на что обратить внимание новичку и какие ошибки чаще всего приводят к отказу.

Что нужно до подключения

Перед тем как нажать кнопку «Подключить магазин», стоит собрать несколько базовых вещей. Без них заявка либо не пройдёт, либо зависнет на модерации. Мы столкнулись с этим лично: первая попытка затянулась, потому что сайт был ещё сырой, а оферта лежала в неочевидном месте. Лучше потратить один день на подготовку, чем потом переделывать половину страниц.

Юридический статус: ООО, ИП или самозанятость

ЮKassa работает с юридическими лицами и индивидуальными предпринимателями. В некоторых случаях подойдёт и статус самозанятого, но тут есть нюансы, которые зависят от типа продукта и объёма платежей. Если ты только тестируешь идею и продаёшь цифровой продукт небольшими партиями, самозанятость может стать точкой входа. Если планируешь серьёзный оборот, договоры и команду — удобнее открыть ИП или ООО.

Что понадобится в любом случае:

• ИНН и ОГРН (или ОГРНИП для ИП).
• Расчётный счёт в российском банке.
• Доступ к личному кабинету налогоплательщика или налогового приложения, потому что ЮKassa может запросить подтверждение статуса.
• Понимание, кто будет подписывать договор: директор ООО, сам ИП или самозанятый.

Мы подключались на ИП, потому что на старте это было быстрее и проще, чем ООО. Если ты сомневаешься, какая форма подойдёт именно тебе, посмотри наш обзор приёма платежей в РФ — там мы разбираем разные способы и ограничения для начинающих.

Работающий сайт или бот с офертой

Это самое важное требование, которое новички часто недооценивают. ЮKassa смотрит на твой сайт или бота и проверяет, действительно ли ты продаёшь то, что заявляешь. Главный документ — публичная оферта. Это договор, который пользователь заключаёт с тобой автоматически, когда нажимает «Оплатить». В оферте должно быть понятно: что продаётся, сколько стоит, как происходит оплата, возврат и передача товара.

Что проверяют:

• Сайт открывается, нет вечной загрузки или пустой заглушки.
• На сайте есть контакты: email, телефон или форма связи.
• Есть описание товара или услуги с ценами.
• Оферта доступна по прямой ссылке и оформлена как отдельная страница.
• Если продукт цифровой — указано, как пользователь получит доступ после оплаты.

Если ты подключаешь бота в Telegram, требования похожие: в описании бота или в стартовом сообщении должна быть ссылка на оферту, контакты и понятное описание того, что человек покупает.

Мы проходили модерацию дважды. В первый раз оферта была вложена в подвал сайта мелким шрифтом, и нам пришёл отказ с просьбой вынести её в отдельный раздел. После исправления заявку одобрили.

Понимание своего продукта

Звучит очевидно, но многие начинающие предприниматели пишут в заявке что-то вроде «всё для бизнеса» или «цифровые услуги». Чем конкретнее ты опишешь продукт, тем быстрее пройдёт проверка. Например:

• «Доступ к премиум-уровням в браузерной игре "Змейка" на месяц».
• «Подписка на закрытый Telegram-канал с уроками по вайбкодингу».
• «Проверка кода приложения с ИИ-ассистентом: пакет из пяти сессий».

Конкретика помогает не только модератору, но и тебе самому: ты чётко понимаешь, за что берёшь деньги.

Регистрация магазина пошагово

Когда документы и сайт готовы, можно заводить магазин в личном кабинете ЮKassa. Мы не будем пересказывать каждую кнопку интерфейса, потому что дизайн кабинета периодически меняется, а названия пунктов могут отличаться. Вместо этого опишем общую логику, которую нужно пройти. Актуальные скриншоты и подсказки смотри на официальном сайте ЮKassa.

Основные шаги

1. Создание аккаунта. Регистрируешься на сайте ЮKassa на рабочую почту, к которой есть доступ у тебя и у бухгалтера. После подтверждения email попадаешь в личный кабинет.
2. Выбор типа бизнеса. Указываешь юридический статус: ООО, ИП или самозанятость. Система запросит ИНН, и часть данных подтянется автоматически.
3. Заполнение реквизитов. Добавляешь расчётный счёт, БИК банка, контакты. Расчётный счёт должен принадлежать тому же ИП или компании, которую подключаешь.
4. Описание сайта или бота. Указываешь адрес сайта или ссылку на бота, категорию бизнеса и подробно описываешь продукт. Мы писали ссылку на сайт, страницу с офертой, страницу с тарифами и краткое описание: кто покупает и что получает.
5. Загрузка документов. В некоторых случаях нужны скриншоты сайта или подтверждение права на домен. Мы загружали скриншоты главной страницы, тарифов и оферты.
6. Отправка на модерацию. После заполнения всех полей отправляешь заявку. Сроки зависят от загрузки поддержки. Пока идёт проверка, можешь параллельно изучать документацию API — это сэкономит время.

Тестовый и боевой режим

Одна из самых полезных функций ЮKassa — возможность работать в тестовом режиме до запуска реальных платежей. Это как песочница в игре: ты можешь попробовать все механики, ничего не ломая и не рискуя деньгами.

Зачем нужен тестовый режим

В тестовом режиме можно:

• Создавать тестовые платежи.
• Проверять, правильно ли формируется ссылка на оплату.
• Тестировать вебхуки — уведомления о статусе платежа.
• Проверить, что после успешной оплаты пользователь попадает туда, куда нужно.
• Отработать сценарий неуспешной оплаты.

Мы в тестовом режиме провели несколько десятков «покупок», прежде чем включить боевой. Это помогло найти ошибку: у нас вебхук приходил, но сайт не всегда правильно его обрабатывал, и доступ к продукту не открывался. Лучше поймать это на тесте, чем объяснять реальному клиенту, почему он заплатил, а доступа нет.

Как переключаться между режимами

В личном кабинете обычно есть переключатель «Тестовый / Боевой режим». У каждого режима свои ключи API: в тестовом одни, в боевом — другие. Важно не перепутать их в коде. Мы храним ключи в переменных окружения и переключаем их через настройки окружения: локально — тестовые, на продакшене — боевые.

Что проверить перед переходом в бой

Перед боевым режимом обязательно проверь: тестовый платёж проходит от начала до конца, после успешной оплаты открывается доступ к продукту, при отмене платежа товар не выдаётся, вебхук корректно обрабатывает разные статусы, а на сайте видны оферта и контакты. Когда всё отработано, меняешь ключи API на боевые и делаешь пробный платёж самому себе на небольшую сумму. Если деньги прошли и доступ открылся — можно открывать доступ пользователям.

Интеграция с сайтом: API и вебхуки простыми словами

Теперь самое интересное — как сайт общается с ЮKassa. Для новичка это часто выглядит как магия: нажал кнопку, деньги ушли, доступ открылся. На самом деле всё работает через API и вебхуки. Объясним на житейском примере.

Что такое API

API — это способ, которым две программы разговаривают друг с другом. Скажем, ты сидишь в ресторане. Ты не ходишь на кухню сам, а даёшь заказ официанту. Официант передаёт заказ повару, потом приносит готовое блюдо. API — это такой официант между твоим сайтом и ЮKassa.

Когда пользователь нажимает «Купить», твой сайт через API отправляет в ЮKassa запрос: «Вот заказ, вот сумма, вот описание, дай ссылку на оплату». ЮKassa отвечает: «Вот ссылка, по которой нужно перейти для оплаты». Пользователь уходит на страницу ЮKassa, вводит карту, подтверждает платёж, а затем возвращается обратно на сайт.

Пример на «Змейке»

Допустим, в нашей учебной игре «Змейка» есть магазин скинов. Игрок нажимает кнопку «Купить золотую змейку за 199 ₽». Что происходит:

1. Сайт формирует заказ: id заказа, сумма 199 ₽, название «Золотая змейка».
2. Сайт отправляет запрос в API ЮKassa: «Создай платёж на 199 ₽».
3. ЮKassa возвращает ссылку на оплату.
4. Сайт перебрасывает игрока по этой ссылке.
5. Игрок оплачивает картой на странице ЮKassa.
6. ЮKassa присылает вебхук на сайт: «Платёж по заказу №123 успешен».
7. Сайт отмечает в базе данных, что у игрока теперь есть золотая змейка.
8. Игрок возвращается в игру и видит новый скин.

Без API и вебхуков сайт не узнает, заплатил ли человек. Поэтому важно настроить оба направления: исходящий запрос от сайта к ЮKassa и входящее уведомление от ЮKassa на сайт.

Что такое вебхук

Вебхук — это автоматическое сообщение от одного сервиса другому. Вернёмся к аналогии с рестораном: если API — это официант, который приносит тебе меню и забирает заказ, то вебхук — это звонок повара, когда блюдо готово. ЮKassa сама звонит твоему сайту и сообщает: «Платёж прошёл» или «Платёж отменён».

Вебхук приходит на специальный URL, который ты указываешь в настройках магазина. Например: https://toysait.ru/api/yookassa/webhook. Твой сайт должен уметь принимать этот запрос, проверять подпись (чтобы не обработать поддельное сообщение) и менять статус заказа.

Пример псевдокода

Если ты работаешь с ИИ-ассистентом, можешь дать ему примерно такую задачу: «При получении вебхука от ЮKassa проверь подпись по секретному ключу. Если статус платежа succeeded и сумма совпадает с заказом — отметь заказ как оплаченный и открой доступ к продукту. Если статус canceled — отправь пользователю письмо с предложением повторить попытку».

Конкретные названия полей, методов и формат подписи всегда смотри в официальной документации ЮKassa. Там есть примеры для разных языков программирования, и ИИ-ассистент легко адаптирует их под твой проект.

Где хранить ключи

Ключи API — это как пароли от банковского счёта. Никогда не храни их прямо в коде, особенно если код публичный, например в открытом репозитории на GitHub. Мы храним ключи в переменных окружения, а код берёт их оттуда. На продакшене ключи задаются в настройках хостинга, локально — в файле .env, который не попадает в репозиторий.

Если ты только начинаешь и работаешь с Claude Code или другим ИИ-ассистентом, попроси его настроить загрузку ключей из переменных окружения. Это стандартная практика, и любой нормальный инструмент подскажет, как сделать правильно.

Чеки 54-ФЗ и фискализация

В России при продаже товаров и услуг обычно нужно формировать чеки. Это требование 54-ФЗ. Если ты принимаешь оплату через ЮKassa, у тебя есть два пути: подключить собственную онлайн-кассу или использовать фискализацию самой ЮKassa. Второй вариант проще для новичка, потому что не нужно покупать и регистрировать кассовый аппарат самостоятельно.

Когда нужен чек

Если ты продаёшь цифровой продукт, подписку, доступ к сервису или физический товар физическому лицу — скорее всего, чек нужен. Если платит юридическое лицо по безналичному расчёту, правила могут отличаться.

В нашем случае — продажа доступа к онлайн-продукту — чек обязателен. Мы подключили фискализацию через ЮKassa, и теперь после каждой оплаты покупатель автоматически получает чек на email или по SMS.

Как это работает на практике

Когда пользователь оплачивает заказ, ЮKassa автоматически отправляет данные в свою фискальную службу, формирует чек и передаёт его покупателю. В чеке обычно указываются название товара, стоимость, количество, НДС (если применяется), реквизиты магазина и способ оплаты. Тебе не нужно делать дополнительных действий вручную, но в личном кабинете можно настроить шаблоны чеков, чтобы название товара совпадало с тем, что описано на сайте.

Мы настроили чеки сразу после перехода в боевой режим. До этого в тестовом режиме проверяли, что сумма, название товара и email покупателя передаются корректно. Один раз обнаружили, что в чеке вместо полного названия продукта шло что-то вроде «Услуга #123». Исправили шаблон — и чек стал понятным для покупателя.

Частые причины отказа модерации

Модерация в ЮKassa — не формальность. Служба безопасности проверяет, что ты продаёшь легальный продукт, что сайт соответствует требованиям и что риски для платёжной системы минимальны. Вот ошибки, которые чаще всего приводят к отказу или доработкам.

Сайт без оферты или с плохой офертой

Если на сайте нет публичной оферты, или она спрятана так, что её невозможно найти за несколько кликов — отказ почти гарантирован. Оферта должна быть отдельной страницей, а не абзацем внизу главной. В ней должны быть прописаны предмет договора, цена, порядок оплаты, возврата и передачи товара.

Неполные или неверные реквизиты

ИНН, ОГРН, расчётный счёт, БИК — всё должно совпадать с данными в ЕГРЮЛ или ЕГРИП. Малейшая опечатка может привести к приостановке. Перед подачей заявки перепроверь цифры.

Сайт-заглушка или неработающий функционал

Если по ссылке открывается страница «Скоро открытие» или форма оплаты не работает, модератор не одобрит заявку. Сайт должен выглядеть живым: работающие ссылки, корректное отображение на мобильных устройствах, понятный путь от главной страницы до оплаты.

Описание товара не соответствует реальности

Если в заявке написано «обучающий курс по программированию», а на сайте продаются услуги непонятного содержания — это повод для отказа. Убедись, что описание в заявке, на сайте и в оферте говорят об одном и том же.

Продажа ограниченных категорий

ЮKassa, как и любая платёжная система, не работает с определёнными категориями товаров и услуг: финансовые пирамиды, азартные игры без лицензии, запрещённые товары и так далее. Если твой продукт находится в серой зоне, лучше заранее уточнить в поддержке, возможно ли его подключение.

Скрытые или фейковые контакты

На сайте должны быть реальные контакты: email, телефон, форма обратной связи или ссылки на социальные сети. Если email не работает, телефон не отвечает, а в соцсетях пусто — модератор может заподозрить, что бизнес ненастоящий.

Неправильно оформленная сфера деятельности

Иногда проблема не в сайте, а в кодах ОКВЭД. Если ты указал в заявке деятельность, которая не совпадает с зарегистрированной, ЮKassa может запросить пояснения. Перед подключением сверь основной ОКВЭД с тем, что ты реально продаёшь.

Сколько стоит подключение и использование

Стоимость — вопрос, который волнует каждого начинающего предпринимателя. Точные проценты мы не будем писать, потому что комиссия ЮKassa зависит от оборота, способа оплаты и индивидуальных условий, и она периодически меняется. Актуальные цифры всегда смотри на официальном сайте сервиса.

Из чего складывается цена

Обычно есть два компонента:

1. Комиссия с каждого платежа. Это процент от суммы операции. Размер зависит от способа оплаты: обычно комиссия за оплату картой отличается от комиссии за СБП или электронные кошельки. Чем больше оборот, тем ниже может быть процент.
2. Абонентская плата или подключение. В некоторых тарифах может быть ежемесячная плата за обслуживание магазина. В других — только комиссия с платежей.

Мы выбрали тариф, где платишь процент с платежа без фиксированной абонентской платы. На старте это удобно: пока нет продаж, нет и расходов. Когда оборот вырос, стали смотреть в сторону более выгодных условий.

Что ещё учитывать

Помимо комиссии ЮKassa, в бизнесе есть сопутствующие расходы:

• Банковские комиссии за вывод денег или обслуживание расчётного счёта.
• Налоги в зависимости от выбранного режима.
• Расходы на онлайн-кассу или фискализацию, если она не входит в тариф.
• Хостинг сайта и домен.

Не забывай закладывать эти расходы в цену продукта. Если ты продаёшь подписку за 500 ₽, а комиссия и налоги съедают заметную часть, маржа может оказаться неожиданно маленькой.

Частые вопросы

Можно ли подключить ЮKassa к боту в Telegram?

Да, можно. Логика та же, что и для сайта: пользователь нажимает кнопку, бот через API создаёт платёж в ЮKassa и присылает ссылку на оплату. После оплаты ЮKassa отправляет вебхук на сервер бота, и бот выдаёт товар или доступ. Главное — в описании бота и в стартовом сообщении должна быть ссылка на оферту и контакты.

Нужен ли сайт, если я принимаю оплату только в боте?

Зависит от требований модерации на момент подключения. В некоторых случаях достаточно полноценно оформленного бота с офертой. В других — модератор может попросить ссылку на сайт или лендинг с описанием продукта. Мы рекомендуем сделать хотя бы небольшую страницу: она повышает доверие и упрощает прохождение проверки.

Что делать, если пришёл отказ на модерации?

Не паникуй. В письме об отказе обычно указана причина или список доработок. Исправь замечания и отправь заявку повторно. Если формулировка непонятна, напиши в поддержку ЮKassa с конкретными вопросами. Мы так делали, и поддержка помогла разобраться, какая именно страница сайта вызвала вопросы.

Можно ли принимать платежи без чеков?

Технически настройка может работать и без фискализации, но юридически для большинства товаров и услуг в РФ чек обязателен. Риски работы без чеков могут включать штрафы и блокировку магазина. Лучше сразу настроить фискализацию через ЮKassa или подключить онлайн-кассу. Подробнее про требования к данным пользователей можно почитать в нашей статье про 152-ФЗ для владельца приложения.

Сколько времени занимает подключение?

При хорошей подготовке зарегистрировать аккаунт и заполнить заявку можно за один-два часа. Модерация обычно занимает от нескольких часов до нескольких рабочих дней. Техническая интеграция зависит от твоего сайта: если у тебя простой лендинг и готовый код от ИИ-ассистента, настройка API и вебхуков может занять один-два дня.

Заключение

Подключить ЮKassa к сайту или боту вполне реально, даже если ты не программист. Главное — подготовить документы, сделать нормальный сайт с офертой и пройти модерацию честно. Техническая часть, особенно если ты работаешь с ИИ-ассистентом, решается за несколько дней: API отправляет запрос, вебхук возвращает ответ, сайт открывает доступ.

Мы сами прошли этот путь и продолжаем принимать оплату через ЮKassa. Самое сложное — не настройка кода, а подготовка: понять свой продукт, оформить оферту и не торопиться с переходом в боевой режим, пока не оттестируешь все сценарии.

Если хочешь разобраться с приёмом платежей и другими шагами запуска цифрового продукта — посмотри наш практический курс. Там мы идём от первой настройки окружения до готового приложения, к которому можно подключить оплату и начать продавать.