Инструкции17 минут чтения

Как подключить оплату в Telegram-боте: сервисы, заказы, чеки и возвраты

Клиент выбирает товар в боте, нажимает «Оплатить» и получает подтверждение заказа. Снаружи всё выглядит просто. Чтобы это работало и у продавца, нужно связать бота с платёжным сервисом, правильно выдавать чеки и заранее продумать возвраты. Разберём, как собрать эту систему и в каких случаях вместо оплаты картой Telegram требует Stars.

Как подключить оплату в Telegram-боте: сервисы, заказы, чеки и возвраты
В этой статье

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

Начните с двух вопросов: что именно вы продаёте и что должно произойти после оплаты. От первого зависит допустимый способ расчёта. От второго - нужен ли вам простой счёт в переписке, конструктор с автоматизацией или собственная разработка.

Когда можно принимать рубли, а когда нужны Telegram Stars

У Telegram разные правила для физических и цифровых товаров. Продажа букета с доставкой и продажа файла через бота - разные платёжные сценарии, даже если кнопки выглядят одинаково.

На телефоне таблицу можно прокрутить в сторону →

Что покупает клиентКак организовать оплатуЧто учесть
Физический товар: букет, одежду, изделие ручной работыОбычный платёжный провайдер: встроенная форма Telegram или платёжная страницаПодключение продавца, наличие товара, доставка и чеки
Офлайн-услугу: уборку, ремонт, очный сеанс массажаПлатёжный сервис для разрешённого вида деятельностиДата, условия услуги и отмены заказа
Цифровой товар или услугу внутри бота: файл, доступ к функциям, цифровой контентTelegram StarsВыдача покупки, поддержка, возврат Stars и получение вознаграждения
Смешанный продукт с онлайн- и офлайн-частьюСначала определить правила для конкретной покупкиНе выбирать способ оплаты только по названию продукта

Для цифровых товаров и услуг внутри Telegram действуют правила оплаты через Stars. Наличие своего сайта само по себе не освобождает от них. Поэтому кнопка со сторонней платёжной ссылкой не является универсальным способом заменить Stars при продаже цифрового продукта через бота.

Дальше обычный эквайринг разбираем на примере физических товаров и разрешённых офлайн-услуг. Для цифровых продаж есть отдельный раздел про Stars. Техническая возможность вставить ссылку ещё не означает, что она подходит вашему продукту по правилам Telegram.

Если задача - платный канал с регулярным доступом, сначала посмотрите руководство как сделать платный канал в Телеграмме. Здесь сосредоточимся на заказах: что выбрали, сколько заплатили, что получили и что вернули.

Три способа добавить оплату в бота

Платёжная ссылка в сообщении

Бот отправляет кнопку «Оплатить 3 200 ₽». Она открывает страницу платёжного сервиса, где клиент выбирает доступный способ оплаты. После этого результат должен вернуться в систему, которая ведёт заказ.

Это удобный старт, если бот уже умеет собирать заявки. При нескольких заказах в день можно сначала подтверждать оплату вручную по кабинету сервиса. Для автоматизации нужна обратная связь: платёжный сервис сообщает боту, какой заказ оплачен.

Одна общая ссылка для всех покупателей неудобна для учёта. Создавайте отдельный счёт или передавайте уникальный номер заказа. Тогда два одинаковых платежа по 3 200 ₽ не придётся различать по времени и фамилии.

Встроенная платёжная форма Telegram

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

Подключение начинается в BotFather: выбираете своего бота и раздел Payments, затем доступного провайдера. Полученный платёжный токен нужно передать в настройки подходящего конструктора или разработчику. Сам по себе токен не создаёт каталог, учёт заказов и отправку чеков.

Набор способов оплаты зависит от этой конкретной интеграции. Наличие СБП или рассрочки у сервиса в целом ещё не означает, что они появятся во встроенной форме Telegram.

Готовый магазин или сценарий в конструкторе

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

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

Как выглядит нормальный заказ в боте

Представим цветочную мастерскую. Клиент покупает букет за 2 900 ₽ и доставку за 300 ₽. Итоговая сумма - 3 200 ₽.

До отправки счёта бот уточняет адрес и время доставки, сохраняет телефон для связи и контакт для чека. Затем создаёт заказ, например TG-1042. Этот номер сопровождает покупку в боте, платёжном сервисе и системе учёта.

После подтверждённой оплаты клиенту приходит понятное сообщение:

Заказ TG-1042 оплачен: букет 2 900 ₽, доставка 300 ₽. Привезём завтра с 12:00 до 14:00 по указанному адресу. Чек отправлен на вашу почту. Если нужно изменить заказ, нажмите «Связаться с нами».

Фразу про отправленный чек бот должен показывать, когда отправка действительно подтверждена. Если касса ещё обрабатывает документ, лучше написать: «Оплата получена. Чек отправим на указанную почту» - и проконтролировать результат.

Схема оплаты в Telegram-боте: заказ, подтверждение платежа, чек и возврат

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

Какие сервисы можно подключить

У пяти сервисов Findpay есть разные инструменты для приёма платежей. Важнее всего выбрать подходящий путь подключения к вашему боту, а затем проверить кассу и обработку результата.

На телефоне таблицу можно прокрутить в сторону →

СервисПрактический путь подключенияНа что обратить внимание
ЮKassaПровайдер в BotFather, конструктор или собственная интеграция по APIВстроенная интеграция Telegram имеет ограничения; чеки нужно настроить
РобокассаПровайдер для своего бота, готовая витрина или платёжные ссылкиВыбрать нужный инструмент: магазин, выставление счетов или интеграцию
ПродамусПлатёжная страница и интеграция с конструктором, например SalebotНужны обратные уведомления об оплате, а не только кнопка со ссылкой
GetPlatinumПлатёжные ссылки и API-интеграция, в том числе с SalebotВ сценарии отдельно настраиваются создание платежа и получение его результата
CloudPaymentsПлатёжная ссылка через API или поддерживающий сервис конструкторПодключает ИП и организации; для чеков выбирается кассовое решение

Самозанятым без ИП подходят для рассмотрения Продамус, GetPlatinum, Робокасса и ЮKassa. CloudPayments рассчитан на ИП и организации. При этом допустимость самого бизнеса нужно проверять отдельно: например, НПД не подходит для обычной перепродажи чужих товаров.

ЮKassa: подключение через BotFather

Для собственного бота у ЮKassa есть штатный путь через Telegram Payments:

  1. Подключите магазин ЮKassa и убедитесь, что он работает по протоколу API.
  2. В BotFather отправьте /mybots, выберите бота и откройте Payments.
  3. Выберите подключение ЮKassa. Для проверки используйте тестовый вариант.
  4. Авторизуйтесь через бота ЮKassa и предоставьте доступ к нужному магазину.
  5. Вернитесь в BotFather за платёжным токеном. Настройте отправку счетов и обработку успешного платежа в своём боте.
  6. Подключите передачу состава покупки и контакта клиента для чеков.

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

Робокасса: свой бот или готовая витрина

Для подключения собственного бота используется RobokassaPaymentBot. Через BotFather выбирается Робокасса как платёжный провайдер, затем бот связывается с магазином Робокассы.

Если своего магазина ещё нет, можно начать с RobokassaShopBot: это инструмент для создания витрины с карточками товаров. Robomerchant_bot решает другую задачу - помогает продавцу выставлять счета и работать с оплатами. Эти инструменты не стоит путать между собой.

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

Продамус: пример подключения через Salebot

В Salebot можно подключить платёжную форму Продамуса и получать результат оплаты в сценарии бота.

  1. Получите адрес платёжной формы и секретный ключ в Продамусе.
  2. В разделе «Эквайринг» Salebot добавьте Продамус и сохраните эти данные.
  3. В настройках формы Продамуса укажите адрес уведомлений, который предусмотрен интеграцией Salebot.
  4. Добавьте кнопку с функцией «Оплата»: передайте товар, сумму и необходимые данные для чека.
  5. Настройте действие после подтверждения успешной оплаты: обновление заказа и сообщение клиенту.

У Salebot эта интеграция описана для тарифа «Инфобиз». Учитывайте стоимость конструктора отдельно от условий Продамуса. Клик по кнопке не должен запускать ту же цепочку, что и подтверждённый платёж.

GetPlatinum: создание ссылки и обратное уведомление

У GetPlatinum есть инструкция по API-интеграции с Salebot. Ключ берётся в разделе «Настройки - Организации» GetPlatinum. Затем в Salebot настраивается запрос на создание платежа с номером заказа, суммой, товарами и контактами клиента.

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

Здесь особенно важно не остановиться на получении ссылки. Проверьте, что результат возвращается именно в карточку нужного клиента и заказа. Если не хотите разбираться с API-запросами, закладывайте помощь специалиста по конструктору.

CloudPayments: ссылка через API и подтверждение заказа

Для собственного бота можно создавать платёжные ссылки через API CloudPayments. В запрос передаются сумма, назначение платежа и номер заказа. Полученную ссылку бот отправляет клиенту, а после оплаты получает уведомление от сервиса.

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

Фискализацию настраивают отдельно через подходящее решение, например CloudKassir или «Cloud-чеки», с учётом условий подключения. Наличие платёжной ссылки само по себе не означает, что касса уже получает состав покупки.

Сравните сервисы в таблице Findpay: отметьте свой статус, нужную кассу, способы оплаты и интеграции. Для бота важна вся цепочка, включая уведомления и возвраты, поэтому одной низкой комиссии недостаточно.

Как не потерять оплату между ботом и заказом

У платёжной страницы может быть кнопка «Вернуться в магазин». У бота - кнопка «Я оплатил». Ни одна из них не подтверждает поступление денег. Клиент может нажать её случайно или закрыть страницу до завершения платежа.

Основание для подтверждения заказа - проверенный результат от платёжной системы. В Telegram Payments это событие successful_payment. При оплате по внешней ссылке обычно используется уведомление провайдера, которое разработчик проверяет по правилам его API.

Попросите настроить четыре вещи:

  • Проверку заказа и суммы. Уведомление на 1 000 ₽ не должно закрывать заказ на 3 200 ₽. Валюта тоже должна совпадать.
  • Защиту от повторов. Одно уведомление может прийти несколько раз. Бот не должен создавать повторную доставку или второй чек.
  • Раздельные статусы. «Ожидает оплаты», «Оплачен», «Выполнен», «Частично возвращён» и «Возвращён» описывают разные события.
  • Восстановление после сбоя. Если сервис получил деньги, а бот был недоступен, платёж нужно найти и связать с заказом после восстановления связи.

Для встроенной оплаты Telegram также есть предварительная проверка заказа. Бот должен ответить на неё за 10 секунд. Это момент проверить доступность товара, но отправлять заказ в работу нужно после успешного платежа.

Покупателю не нужны названия технических статусов. Ему нужен ответ: «Оплату пока не получили», «Заказ принят» или «Деньги возвращены». А сотруднику - возможность открыть платёж и понять, что произошло.

Какие чеки отправлять клиенту

Сообщение «Оплачено» в Telegram и банковская квитанция не заменяют кассовый чек или чек самозанятого.

Для ИП и ООО

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

Настройте передачу наименований, количества, стоимости товаров, налоговых реквизитов и контакта для электронного чека. В нашем примере букет и доставка должны корректно попадать в документы, а не превращаться в безликое «Пополнение баланса».

Если деньги поступают заранее, а товар передаётся позже, по общему правилу оформляются чек на предоплату и затем чек на её зачёт. Для отдельных случаев есть специальные разъяснения, в том числе для УСН. Не считайте второй чек автоматически обязательным или автоматически ненужным: выберите подходящую схему с кассовым сервисом. Подробности разобраны в статье про онлайн-кассу для ИП на УСН, а общий порядок описывает ФНС.

Для самозанятого

При работе на НПД формируется чек через «Мой налог» или уполномоченного партнёра. У Продамуса, GetPlatinum и Робокассы есть соответствующие интеграции. У ЮKassa приём платежей самозанятым доступен, но выдачу чеков НПД нужно организовать отдельно.

Проверьте не только создание чека, но и его отправку клиенту. Если используете автоматическую интеграцию, не дублируйте тот же доход вручную. При возврате денег нужно корректно изменить сведения о доходе; простого сообщения в боте недостаточно.

Как сделать полный или частичный возврат

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

Для рублёвого платежа порядок такой:

  1. Найдите заказ и исходную успешную оплату. Уточните, что возвращаете: весь заказ, отдельный товар или часть услуги.
  2. Создайте возврат через кабинет платёжного сервиса либо поддерживаемую интеграцию. Укажите сумму и состав возвращаемых позиций.
  3. Проверьте, достаточно ли средств для операции и какой статус вернул сервис.
  4. Оформите необходимые документы: для расчёта с ККТ - чек «Возврат прихода», для НПД - корректировку сведений в «Моём налоге».
  5. Обновите заказ в боте и отправьте покупателю сумму возврата и понятный статус. Отдельно проверьте завершение операции.

Пример частичного возврата. Клиент оплатил букет с доставкой за 3 200 ₽, но вы согласовали самовывоз и возврат 300 ₽ за доставку. Возвращаются 300 ₽ из исходного платежа. Заказ остаётся оплаченным на 2 900 ₽, доставка отменяется, документы оформляются на возвращённую часть.

При этом кнопки возврата в кабинете провайдера и в конструкторе бота могут иметь разные возможности. Если конструктор не умеет частичный возврат, его можно провести доступным способом у провайдера, а затем обновить заказ и сообщение клиенту.

Отдельно выясните судьбу комиссии. «Нет дополнительной платы за возврат» не означает «вернётся комиссия за первоначальную оплату». Не переносите автоматически этот расход на покупателя. Условия и порядок по сервисам собраны в руководстве как вернуть клиенту оплату полностью или частично.

Как устроена оплата цифровых товаров через Stars

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

Для продавца Stars не равны обычному рублёвому поступлению на расчётный счёт. Получение вознаграждения организовано через Fragment, может быть доступно не всем пользователям и странам, а полученные Stars могут оставаться недоступными для вознаграждения до 21 дня. Не рассчитывайте себестоимость по формуле «сколько клиент заплатил за Stars, столько я получу». Условия изложены в правилах для разработчиков Telegram.

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

У бота должна работать команда /paysupport для обращений по оплате. Возврат покупки выполняется в Stars. Метод refundStarPayment возвращает платёж целиком; параметра для произвольной частичной суммы в нём нет. Поэтому не обещайте покупателю привычный частичный возврат в рублях из кабинета эквайринга.

Сколько стоит приём оплаты в боте

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

Простой учебный расчёт: при обороте 100 000 ₽ и условной комиссии 3,5% обработка платежей стоит 3 500 ₽. Если конструктор обходится в 2 000 ₽ в месяц, получается 5 500 ₽ до расходов на кассу, настройку и других возможных платежей. Это пример расчёта, а не тариф конкретного сервиса.

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

Для Stars нужен отдельный расчёт по фактически доступному вознаграждению и расходам на его получение. Сравнивать этот путь с эквайрингом только по заявленному проценту некорректно.

Что проверить перед запуском

Пройдите путь покупателя с телефона. Для тестовых операций используйте предусмотренный сервисом режим, а реальные проверки проводите по согласованному с ним порядку.

На телефоне таблицу можно прокрутить в сторону →

ПроверкаКакой результат нужен
Успешная оплатаОдин оплаченный заказ, правильная сумма, подтверждение клиенту
Клиент закрыл оплатуЗаказ остаётся неоплаченным, его можно продолжить без путаницы
Двойное нажатие или повтор уведомленияНет повторной доставки и дублирования документов
Деньги получены во время сбоя ботаПосле восстановления платёж находится и связывается с заказом
Ошибка при формировании чекаСотрудник видит проблему и может её устранить
Полный возвратСовпадают сумма, статус у провайдера, документы и сообщение клиенту
Частичный возврат в рублёвой схемеСохраняется оплаченный остаток и правильный состав заказа
Обращение в поддержкуКлиент понимает, кому написать, а сотрудник видит номер покупки

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

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

Можно ли подключить оплату без сайта?

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

Можно ли просто добавить одну кнопку со ссылкой?

Можно начать с этого и сверять оплаты вручную. Для автоматической работы нужна связь с конкретным заказом и подтверждение от провайдера. Переход по ссылке или кнопка «Я оплатил» не заменяют проверку платежа.

Будут ли в Telegram доступны все способы оплаты сервиса?

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

Можно ли подключить обычный эквайринг к продаже файла в боте?

Для цифровых товаров и услуг внутри Telegram действуют правила Stars. Само наличие у провайдера возможности принимать оплату за файлы или курсы не отменяет требования площадки.

Кто отвечает, если деньги списались, а бот ничего не прислал?

Покупателю должен помочь продавец. Сначала найдите операцию у провайдера, затем проверьте связь с заказом и доставку уведомления. Предлагать повторную оплату до такой проверки не стоит. Для Stars предусмотрите обращение через /paysupport.

С чего начать, если нет разработчика?

Выберите конкретный сценарий: что продаёте, как клиент получает покупку, нужен ли адрес и как возвращаются деньги. Затем проверьте готовую витрину или конструктор с нужным провайдером. Просите показать весь путь на одном тестовом заказе, включая чек и возврат. Так проще понять объём настройки до оплаты работы.

Брежнев Василий - Технический специалист по настройке онлайн-сервисов
Автор статьи

Брежнев Василий

Технический специалист по настройке онлайн-сервисов

С 2018 года внедряю и настраиваю платёжные системы в онлайн-школах, воронках и инфобизнесе. Помогаю экспертам и блогерам начать официально продавать свои продукты и услуги онлайн. А также публикую здесь материалы, которые позволят вам самостоятельно и быстро подобрать наилучшие сервисы и платформы по вашим критериям.

Как мы оцениваем сервисы →
Вернуться к списку статей
Персональный подбор

Найдите решение для ваших задач

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

Подобрать системуТаблица сравнения
2 минуты
Без регистрации
Комиссии
Сравните условия
Подключение
Под ваш сценарий
Системы
В одной таблице
Читайте также

Полезные материалы по теме