Чеки самозанятого в Telegram-боте: как выдавать после оплаты через ЮKassa
За каждую оплату в боте самозанятый выдаёт чек. ЮKassa с 29 декабря 2025 года чеки НПД не формирует, поэтому доход регистрируют в «Мой налог» отдельно — вручную или автоматически после подтверждённой оплаты. Ссылку на готовый чек бот может отправить покупателю сам.
Как бот принимает оплату через ЮKassa
Есть два распространённых способа.
Платежи Telegram через BotFather. В @BotFather в разделе Payments подключают ЮKassa и получают платёжный токен. Бот выставляет счёт методом sendInvoice, покупатель платит, не выходя из Telegram. Магазин ЮKassa для этого должен работать по протоколу API. Принимаются российские банковские карты, ЮMoney и SberPay, а автоплатежи и холдирование в этом сценарии недоступны.
После оплаты бот получает сообщение SuccessfulPayment. В его поле provider_payment_charge_id лежит номер платежа в ЮKassa — по нему платёж находится в личном кабинете ЮKassa. Этот номер понадобится, чтобы связать оплату с чеком.
Ссылка на оплату через API ЮKassa. Бот создаёт платёж в ЮKassa и отправляет покупателю ссылку на страницу оплаты. Этот способ используют, когда нужны регулярные списания по подписке.
В обоих случаях деньги проходят через ваш магазин ЮKassa, а с 29 декабря 2025 года ЮKassa не регистрирует доход самозанятого в «Мой налог». Подробнее: ЮKassa отключила чеки для самозанятых.
Цифровые товары и Telegram Stars
По правилам Telegram цифровые товары и услуги в ботах продаются только за Telegram Stars. Подключение платёжного провайдера, в том числе ЮKassa, Telegram описывает для физических товаров и услуг. Проверьте, к какой категории относится то, что продаёт ваш бот, — это требование Telegram, а не налоговое.
Оплаты в Stars не проходят через ЮKassa, поэтому всё, о чём пишем ниже, их не касается.
Когда и какой чек выдавать
- чек — на каждую оплату, даже небольшую
- при оплате картой, через SberPay или ЮMoney чек формируют в момент расчёта
- чек формируют после подтверждённой оплаты, а не после открытия счёта
- в названии — понятное наименование услуги или товара, а не номер заказа
- покупателю передают ссылку на чек или сам чек — например, сообщением в боте
Заголовок счёта в Telegram ограничен 32 символами. Если название услуги длиннее, не обрезайте его в чеке: передайте в чек полное название из заказа. Подробнее: в какой срок выдать чек и что писать в чеке.
Какие есть варианты
| Способ | Плюсы | Минусы |
|---|---|---|
| Вручную в «Мой налог» | Бесплатно, ничего не нужно подключать | Бот продаёт круглосуточно, а чеки нужно вводить руками после каждой оплаты; ссылку покупателю тоже отправлять вручную |
| Своя интеграция | Полный контроль | Разработка и поддержка: проверка платежа в ЮKassa, защита от дублей, возвраты, поддержание входа в «Мой налог» |
| НПД Чек | Магазин ЮKassa и оплата в боте остаются, чек создаётся после подтверждённой оплаты, ссылку бот получает через API | Платно: 990 ₽ за 30 дней после пробной недели; для передачи названий и отправки ссылки нужно добавить код в бота |
Если продаж в боте несколько в месяц, вручную вполне можно справиться. Если оплаты идут каждый день, ночью или по подписке, ручной ввод начинает отнимать время и создаёт риск пропустить чек.
Как подключить автоматические чеки к боту
НПД Чек работает с вашим действующим магазином ЮKassa. После оплаты сервис сам запрашивает платёж у ЮKassa, проверяет сумму и статус и регистрирует доход в «Мой налог». Один платёж — один чек: повторное уведомление не создаёт дубль.
- Зарегистрируйтесь в кабинете по email и подключите магазин ЮKassa: shopId и секретный ключ.
- Подключите «Мой налог»: подтвердите email, установите программу для Windows и Mac и войдите на странице ФНС из программы. Сессия хранится на вашем компьютере. Пока он выключен или спит, чеки ждут в очереди.
- Включите уведомления ЮKassa об оплатах и возвратах на адрес из кабинета.
- Если нужно своё название в каждом чеке, включите API и передавайте из бота заказ: номер платежа (provider_payment_charge_id), название и сумму. Когда чек готов, бот получает ссылку и отправляет её покупателю.
Описание запросов, статусов и готовый модуль для Cloudflare Workers — на странице API. Подробнее о сценарии — на странице для Telegram-ботов, про регулярные списания — для подписок.
Первые 3 дня бесплатно, без привязки карты и автоматических списаний. Затем 990 ₽ за 30 дней. Комиссия вашего платёжного сервиса и налог оплачиваются отдельно.
Что делать с возвратами
Сначала верните деньги покупателю через ЮKassa. При полном подтверждённом возврате чек аннулируют — в «Мой налог» или в кабинете НПД Чек. При частичном возврате чек заменяют на сумму остатка. Подробнее: как правильно аннулировать чек самозанятого.
Частые вопросы
Нужен ли чек, если оплата в боте небольшая?
Да. Чек формируют при каждом расчёте, сумма значения не имеет. Для оплаты картой, через SberPay или ЮMoney чек формируют в момент расчёта.
Можно ли выдать чек прямо в Telegram?
Да. Чек из «Мой налог» открывается по ссылке, и её можно отправить покупателю сообщением. Бот может сделать это сам, когда чек готов.
Что писать в названии услуги?
Понятное название того, за что заплатил покупатель, например «Персональная тренировка». Заголовок счёта в Telegram ограничен 32 символами, поэтому в чек лучше передавать полное название из заказа.
Подойдёт ли это для подписок в боте?
Платежи через BotFather не поддерживают автоплатежи. Для регулярных списаний используют API ЮKassa, а чек выдают на каждое списание. НПД Чек делает отдельный чек на каждый подтверждённый платёж.
Нужно ли переделывать бота, чтобы подключить НПД Чек?
Магазин ЮKassa и способ оплаты остаются прежними. Чтобы в чеке было название из заказа, а бот сам отправлял ссылку, в бот добавляют вызовы API. Без этого чеки создаются с названием из настроек, а ссылки доступны в кабинете.
Источники
Материал носит информационный характер. Для спорной ситуации сверяйтесь с ФНС или профильным специалистом.