Продажа цифрового файла, доступа или услуги внутри Telegram требует другой платёжной логики, чем доставка физического товара. Для цифровых товаров и услуг Telegram описывает оплату через Stars, отображаемые в Bot API валютой XTR. Бизнесу необходимо определить, когда заказ подтверждён, как выдать доступ ровно к оплаченной покупке, как обрабатывать повторные сообщения о платеже и как делать возврат. Не следует обещать одинаковую комиссию или условия выплаты для любых типов продуктов.
Проверяйте актуальные правила Telegram для цифровых товаров перед разработкой. Они описывают отправку счёта, pre_checkout_query, ответ на запрос и получение successful_payment. Только успешное уведомление об оплате подтверждает факт завершённой покупки; предварительное согласование pre-checkout не является платежом. Сохраните идентификатор платежа telegram_payment_charge_id, который используется при возврате. Если продукт предполагает физическую доставку, не переносите этот сценарий автоматически.
Для смежного понимания исходных условий полезен материал Оплата в Telegram-боте и Mini App: что проверить до разработки, однако нынешняя задача не дублирует его: правила цифровой покупки и подтверждение платежа; не перенос условий физических товаров или обещание одинаковых комиссий. Условия платформы необходимо дополнительно проверить перед запуском. Не начинайте работу, пока не установили, в какой системе находится достоверная запись и кто подтверждает её содержание.
Разделите три состояния: пользователь нажал купить, платёж подтверждён, право доступа выдано. Каждая покупка получает внутренний order_id; после successful_payment сервер проверяет соответствие заказа и выдаёт файл, ссылку или разрешение. Обработка должна быть идемпотентной: повторная доставка события не открывает два независимых заказа. В отдельном журнале отмечайте запрос поддержки, одобренный возврат и фактическое изменение права доступа по утверждённым условиям. Для цифрового доступа требуется продумать, что происходит после отмены и истечения срока, если срок вообще предусмотрен.
Профильное направление Telegram-боты, Mini Apps и автоматизация может включать обсуждаемую задачу. Если отдельные правки относятся к Разработка, доработка и интеграции интернет-магазина, их включают в предложение только после проверки зависимости. Согласуйте не только выходной файл или интерфейс, но и способ самостоятельной проверки, повторного использования и восстановления после ошибки.
Для учебной модели бот продаёт файл за 50 Telegram Stars, валюта платежа — XTR. Состояние payment_status хранится отдельно от entitlement_status (право открыть файл); внутренний order_id связан с telegram_payment_charge_id после подтверждения. Сценарии описывают ожидаемые результаты будущих проверок, не испытания на реальном клиентском аккаунте.
Матрица приёмки: O-101 → 0 платежей/0 выдач; O-102 → 0 подтверждённых/0 выдач; O-103 → 1 подтверждённый/1 доступ; дубли O-103 → по-прежнему 1/1; подтверждённый refund → операция возврата в истории и доступ в состоянии, утверждённом политикой. Для цифровых продаж Telegram также предусматривает запросы поддержки через /paysupport; это отдельный маршрут обработки проблем покупателя. Ожидаемые значения здесь проектные, а не полученные с боевого счёта.
Негативный сценарий: бот выдаёт товар сразу после pre_checkout, пользователь отменяет платёж, но доступ уже предоставлен. Вторая проблема — агент поддержки обещает ручной возврат без сохранённого ID, а разработчики не предусмотрели /paysupport. Telegram прямо описывает обязанности по поддержке цифровых платежей; не следует заменять их ссылкой на общий FAQ. Проверяйте актуальные условия и правила разрешения споров.
В материале Доступ к закрытому контенту через Telegram-бота: выдача, продление и прекращение рассмотрен соседний вопрос; для настоящей задачи важнее не смешивать границы решений. Если спорная операция уже выполнена, сначала зафиксируйте её состояние и согласуйте безопасную коррекцию, затем повторите контрольный тест.
Пять тестов дают правильные статусы, выдача наступает только после подтверждения, повторные события безопасны, идентификатор платежа сохраняется, возврат доступен через поддерживаемый интерфейс и проверяется отдельно. Пользователю понятны условия цифрового товара и способ обратиться в поддержку. Расчёт комиссий и правовые последствия возврата оцениваются отдельно по актуальным правилам и юрисдикции.
Постройте процесс как несколько явно различимых состояний: заказ создан, счёт показан, предварительная проверка пройдена, успешный платёж подтверждён, доступ выдан, возвращено или отменено. Для цифрового продукта нельзя выдавать файл только потому, что клиент нажал кнопку либо бот получил pre_checkout_query. Нужно дождаться подтверждённой операции, после чего проверить, к какому заказу она относится. Сохраняйте собственный ID заказа и telegram_payment_charge_id в защищённой системе, чтобы в дальнейшем сопоставить выдачу, обращение поддержки и возврат.
Практическая проблема возникает между подтверждённым платежом и технической доставкой: если ссылку создаёт отдельный сервис, используйте состояния «выдача запрошена», «выдано» и «ошибка выдачи», привязанные к одному оплаченному order_id. Периодическое задание восстановления должно находить оплаченные заказы без выданного доступа; перед повтором оно сверяет факт выполнения внешней операции, чтобы не создать двойную лицензию. В интерфейсе поддержки отделяйте жалобу «оплата не прошла» от жалобы «оплата подтверждена, но файл не открывается». Сами параметры оплаты проверяют по действующим документам Telegram, а не по фиксированному проценту комиссии из старых материалов.
Платёжное событие иногда обрабатывается повторно при сетевой ошибке или рестарте приложения. Если обработчик всегда создаёт новый оплаченный заказ, клиент может получить два независимых права или два сообщения о выдаче. Проводите идемпотентную проверку по устойчивому идентификатору подтверждённого платежа и внутреннему заказу. Если первая выдача завершилась ошибкой, это должно быть видно в статусе и позволять безопасно повторить доставку. Защита от дублей не должна оставлять оплатившего человека без продукта.
Доступ бывает разным: одноразовая ссылка на файл, добавление в закрытый канал, включение функции Mini App или запись прав в внешнюю систему. Выберите срок, ограничения и способ восстановления в зависимости от продукта. Не считайте сообщение «готово» доказательством, что клиент реально получил доступ. Проверьте тестовым аккаунтом открытие материала и закрытие доступа после согласованного события, если такая функция предусмотрена. Доступ к стороннему API может требовать отдельной интеграции и оценки безопасности.
При обращении о возврате оператор должен видеть заказ, подтверждённый платёж и факт выдачи. Telegram описывает механизм refundStarPayment и требования к поддержке цифровых покупок. Однако основания и последствия возврата зависят от применимых условий и закона; не придумывайте их на этапе программирования. Для теста сначала оформите возврат предусмотренным интерфейсом, затем проверьте статус платежа и связанную с ним политику доступа. Не удаляйте исходную запись — она нужна для выяснения истории операции.
Для обработки обращений храните независимые подтверждения: сообщение об оплате с платёжным ID, запись выдачи доступа и документированный результат запроса возврата. Без них оператор не может объяснить, что произошло, и рискует закрыть доступ раньше фактического возврата. Пользователь должен знать путь к поддержке; недоказанную претензию не объявляют уже возвращённой суммой.
Для оценки продажи цифрового продукта за Stars опишите пять состояний тестовой покупки, условия предоставления доступа, схему поддержки и политику после подтверждённого возврата. Не передавайте реальные платёжные идентификаторы клиента, токены или доступ к боту в открытом чате. Описания услуги и объёма возможных работ доступны в Состав работ и порядок индивидуального предложения; через Обсудить задачу и запросить индивидуальную оценку можно обсудить индивидуальный состав и проверку результата без неподтверждённых гарантий.