Платное медиа в Telegram — это оплата за просмотр прямо в чате. Бот отправляет фото или видео методом sendPaidMedia. Покупатель видит файл закрытым, платит цену в Stars внутри Telegram, и тот же пузырь открывается. Отдельной страницы товара и формы с картой нет.
Tiny Shops делает это из входящих, если магазин в формате чата. Ниже — что пишет сам Telegram, и какие ограничения продукт оставляет более узкими. Сверено со страницей Bot API 24 сентября 2026.
Что видит покупатель#
Закрытое фото или видео с ценой в Stars. Оплата проходит внутри Telegram. Пузырь, который уже лежит в чате, открывается. Аккаунт на вашем сайте для этого файла не нужен, номер карты тоже.
Это одна покупка одного файла. Не подписка и не пост в канале.
Что документирует Telegram#
Со страницы sendPaidMedia, прочитанной 24 сентября 2026:
star_count— целое число от 1 до 25000. Это цена в Telegram Stars.media— списокInputPaidMedia: фото, видео или живое фото, до 10 файлов в одном сообщении.business_connection_idв методе необязателен. Если он передан, сообщение уходит от имени подключения Telegram Business.- Если чат — канал, Stars зачисляются на баланс канала. Иначе — на баланс бота.
Telegram сам забирает файл, чтобы доставить его. Адрес файла — не секретная ссылка на скачивание.
Что отправляет Tiny Shops#
Продукт уже, чем API. Так и задумано.
| Bot API | Продажа в чате Tiny Shops | |
|---|---|---|
| Файл | Фото, видео или живое фото, до 10 | Одно фото или одно видео |
| Цена | 1–25000 Stars | Тот же диапазон, цена вне его отклоняется |
| Подключение | Необязательно | Обязательно. Без Telegram Business входящие ничего не отправят |
| Куда падают Stars | Баланс канала или баланс бота | Баланс вашего бота: это чат, не пост в канале |
| Комиссия платформы | Правила Telegram для Stars | Tiny Shops берёт 0% и не хранит Stars |
Документ отклоняется и как платный, и как бесплатный. PDF, zip или ключ лицензии из этих входящих не отправить. Альбом и живое фото тоже вне этого сценария.
Цена без файла отклоняется. Текстовый ответ остаётся бесплатным.
Что нужно до первой отправки#
- Магазин Tiny Shops в формате чата, не каталог мини-приложения.
- Токен бота из @BotFather, сохранённый на странице бота.
- Бот добавлен в Telegram: Business → Chatbots. Пока подключение не пришло, входящие показывают просьбу подключить бота и ничего не отправляют.
- Покупатель, который писал вам в последние 24 часа. Бизнес-бот отвечает только в этом окне. Когда оно закрыто, поле ответа в Tiny Shops недоступно, пока человек не напишет снова или пока вы не ответите из самого Telegram.
Отправить одно фото#
Откройте тред во входящих. Прикрепите одно фото или одно видео. Введите целое число Stars от 1 до 25000. Отправьте.
Покупатель платит в чате. Сообщение помечается оплаченным. Это не заказ витрины. Заказы, каталог и чекаут относятся к магазину-мини-приложению — другому формату. Как выбрать, написано в статье оплата за просмотр или мини-приложение.
Чего этот сценарий не делает#
- Не принимает карту за файл. Карты, Apple Pay и Google Pay — это чекаут мини-приложения.
- Не возвращает Stars кнопкой в Tiny Shops. Экрана возвратов для этих отправок нет.
- Не хостит пачку файлов и не шлёт ссылку на архив.
- Не продаёт после закрытия 24-часового окна, пока покупатель не напишет снова.
Если нужен каталог, доставка или оплата картой — собирайте мини-приложение. Если следующее фото в переписке должно стоить Stars — это платное медиа.
