Короткий ответ и границы сценария
Telegram-магазин должен создавать заказ до кнопки оплаты, передавать пользователю только pay_url и выдавать товар после подписанного webhook с учётом правил платформы для категории продажи. Материал рассчитан на владельца магазина в Telegram с физическими товарами, бронированиями или другим допустимым внешним сценарием. Сначала определите бизнес-объект, который изменится после оплаты: заказ, бронь, период доступа, лицензия или обязательство перед клиентом.
Покупатель собирает корзину в боте, подтверждает адрес, после чего backend фиксирует состав и цену. Бот отправляет одну кнопку оплаты, а склад получает задачу только после проверенного payment.paid и повторно её не создаёт. Это конкретный пример модели, а не универсальное разрешение для любой категории. Условия подключения, способы оплаты и документы подтверждаются для проекта во время модерации.
У оплаты в Telegram есть два разных слоя. Интерфейс бота или Mini App создаёт заказ и показывает пользователю кнопку, а платёжный сервер формирует счёт, принимает результат и меняет доступ. Секретный ключ нельзя помещать в клиентский JavaScript или сообщение бота: запрос создания платежа выполняет ваш backend.
Как выбрать рабочий вариант
Сравнивайте варианты по тому, какое действие нужно подтвердить и кто отвечает за следующий шаг. В таблице — три контрольные точки именно для темы «прием платежей в Telegram-магазине».
| Контрольная точка | Как зафиксировать | С чем связать |
|---|---|---|
| корзина в боте | Записать принятое решение, владельца и критерий готовности. | кнопка pay_url и внутренний order_id. |
| контакты покупателя | Сохранить выбранное значение и версию условий. | webhook подтверждения и ожидаемый результат. |
| order_id заказа | Определить проверку, состояние ошибки и безопасный повтор. | выдача или доставка, payment_id и время обработки. |
Шесть точек, которые определяют результат
корзина в боте
Контрольная точка «корзина в боте» задаёт исходные данные для материала «Приём платежей в Telegram-магазине: заказ, ссылка и выдача». Зафиксируйте решение в карточке заказа до создания платежа, чтобы повторный запрос не создавал новую продажу случайно.
контакты покупателя
Пункт «контакты покупателя» должен быть понятен покупателю до перехода в форму: покажите сумму, назначение и ожидаемый результат. Интерфейс отдельно объясняет ожидание, успех, отмену и истечение, не подменяя серверный статус красивым экраном.
order_id заказа
Для пункта «order_id заказа» определите техническое доказательство завершения: проверенное событие, совпавшие сумма и валюта, известные order_id и payment_id. Только после этой проверки запускайте продуктовую выдачу или исполнение заказа.
кнопка pay_url
У элемента «кнопка pay_url» должен быть владелец исключений. Ему нужна история попыток и правило, которое объясняет, можно ли безопасно повторить создание, отправку ссылки или выдачу без доступа к API-ключам.
webhook подтверждения
Требование «webhook подтверждения» проверьте повторной доставкой callback. Два одинаковых события не должны дважды продлевать доступ, резервировать место, начислять баланс или отправлять товар; ограничение фиксируют на уровне данных.
выдача или доставка
Для точки «выдача или доставка» заранее опишите возврат, спор и задержку результата. Покупателю нужен понятный канал поддержки, а команде — связь между исходным заказом, платежом, документом и обратной операцией.
Пошаговая схема
- корзина в боте. Связывайте Telegram user_id с внутренним customer_id, но не используйте его как единственный идентификатор заказа. Запишите входные данные, ответственного и условие завершения. Если нужен денежный результат, сообщение пользователя и визуальный редирект не заменяют проверенный серверный статус.
- контакты покупателя. Создавайте новый order_id для каждой покупки и сохраняйте payment_id до отправки ссылки пользователю. Запишите входные данные, ответственного и условие завершения. Если нужен денежный результат, сообщение пользователя и визуальный редирект не заменяют проверенный серверный статус.
- order_id заказа. Разделите сообщения об ожидании, успехе, отмене и истечении срока платежа. Запишите входные данные, ответственного и условие завершения. Если нужен денежный результат, сообщение пользователя и визуальный редирект не заменяют проверенный серверный статус.
- кнопка pay_url. Проверяйте подпись webhook по исходному телу запроса до JSON-разбора. Запишите входные данные, ответственного и условие завершения. Если нужен денежный результат, сообщение пользователя и визуальный редирект не заменяют проверенный серверный статус.
- webhook подтверждения. Повторное событие не должно повторно выдавать доступ или отправлять товар. Запишите входные данные, ответственного и условие завершения. Если нужен денежный результат, сообщение пользователя и визуальный редирект не заменяют проверенный серверный статус.
Шестая точка — выдача или доставка — завершает цикл. Она должна быть видна в личном кабинете или внутренней системе проекта, чтобы поддержка могла восстановить ход операции без доступа к секретным ключам и без просьбы прислать скриншот.
Как собрать сценарий на RollyPay
В сценарии «прием платежей в Telegram-магазине» бот отвечает за диалог, а backend — за секреты и состояние заказа. Сервер фиксирует «корзина в боте», создаёт платёж и передаёт боту только готовый pay_url; X-API-Key не попадает в сообщение или Mini App.
Кнопка реализует пункт «контакты покупателя», но не подтверждает оплату. Backend принимает callback_url, проверяет X-Signature по исходному телу и сопоставляет событие с order_id и payment_id.
Пункт «webhook подтверждения» выполняется один раз после payment.paid. Если пользователь закрыл форму, бот может показать актуальный статус из вашей базы; ему не нужно верить скриншоту или факту возврата на success URL.
Для темы «Приём платежей в Telegram-магазине: заказ, ссылка и выдача» условия и варианты подключения собраны на странице решения RollyPay. Там можно сопоставить сценарий с продуктом, а здесь сохранить инструкцию и контрольные детали для реализации.
Частые ошибки
Нет внутреннего объекта продажи. Пункт «корзина в боте» существует только в переписке, поэтому платёж нельзя однозначно связать с товаром или обязательством. Сначала создайте внутренний заказ и только затем внешний платёж.
Интерфейс принят за доказательство. Пункт «контакты покупателя» может быть кнопкой, QR, ссылкой или экраном возврата. Денежный результат всё равно подтверждают серверное состояние и проверенное событие.
Разорваны данные процесса. Пункты «order_id заказа» и «webhook подтверждения» должны быть связаны через order_id, payment_id, сумму, валюту и последнее событие. Тогда повтор или позднее подтверждение обрабатываются безопасно.
Нет владельца исключений. Пункт «выдача или доставка» включает возврат, истечение, спор и сбой доставки. Для каждого случая нужны статус, ответственная роль и понятное сообщение покупателю.
Что проверить до публикации
Для цифровых товаров и услуг, продаваемых внутри приложений Telegram, официальные правила требуют Telegram Stars. Внешняя платёжная ссылка не является универсальной заменой Stars. Для физических товаров, офлайн-услуг и допустимых внешних сценариев действуют другие варианты, но категорию товара и актуальные правила нужно проверить до запуска.
Надёжный бот не выдаёт товар после простого возврата пользователя на success URL. Он ждёт серверное событие, проверяет подпись, сверяет сумму и order_id, делает операцию идемпотентной и только затем меняет роль, срок подписки или статус заказа.
- Категория проекта и предмет продажи описаны одинаково на сайте, в боте и в заявке на подключение.
- Цена, валюта, срок действия предложения и правила возврата видны до оплаты.
- Секреты находятся только на сервере, а журнал не содержит API-ключей и полного тела с чувствительными данными.
- Успех, отмена, истечение, повтор события и недоступность callback проверены до реальных продаж.
- Налоговый или кассовый документ создаётся по правилам статуса продавца и связан с заказом.