ЮКасса для бота и подписки

ЮКасса нужна, когда бот, сервис или мини-приложение принимает оплату: разовый доступ, подписку, пакет распознаваний, консультацию или другой цифровой продукт.

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

Что подготовить в кабинете ЮКассы

• магазин и его shopId;
• секретный ключ для API;
• тестовый режим, если он доступен;
• URL для webhook, когда будет готов сервер;
• данные для чеков: название товара, ставка НДС, система налогообложения, email или телефон покупателя;
• список событий, которые нужно отправлять на сервер.

Секретный ключ передавайте только в личном сообщении или через защищённый канал. Не вставляйте его в публичные таблицы, документы и репозиторий.

Что решить до разработки

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

Для подписок и рекуррентных платежей могут быть дополнительные требования со стороны ЮКассы. Их лучше проверять до обещания даты запуска.

Что важно технически

Платёж нельзя считать успешным только потому, что пользователь вернулся на страницу после оплаты. Сервер должен получить webhook или сам проверить статус платежа через API.

Для повторов и сетевых ошибок используется идемпотентность: один и тот же платёжный шаг не должен случайно создать два списания или две подписки.

Как проверить запуск

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