Платежи в Telegram позволяют покупателю оплатить заказ боту или Mini App, не выходя из чата. Бот выставляет счёт, Telegram открывает своё платёжное окно, а деньги идут продавцу через платёжного провайдера (за физические товары) или в Telegram Stars (за цифровые). В этом гайде — как устроены платежи в Telegram, какой вариант подходит под ваш товар, сколько стоит каждый и как по шагам начать принимать оплату: с кодом и без.
Полный список способов, которые можно подключить к магазину, включая TON и кошельки Юго-Восточной Азии, — в статье способы оплаты в Telegram. Здесь — о том, как работает оплата в Telegram и как её включить.
Как работают платежи в Telegram#
Bot Payments API — бесплатная открытая платформа Telegram. В ней две дорожки:
- Физические товары и услуги оплачиваются через сторонних провайдеров. Их у Telegram больше 20, платить можно из более чем 200 стран. Комиссию с таких платежей Telegram не берёт и данные карт не хранит — картой занимается провайдер. Платёжное окно Telegram поддерживает Apple Pay и Google Pay.
- Цифровые товары и услуги оплачиваются только в Telegram Stars, код валюты
XTR. Telegram предупреждает: если продавать цифровое за другие валюты или через сторонних провайдеров, бот или Mini App могут не показываться пользователям мобильных приложений.
Платёж всегда проходит одинаково:
- Счёт. Бот отправляет счёт с товарами и суммой (
sendInvoice) или Mini App открывает его по ссылке. - Доставка (по желанию). Если цена доставки зависит от адреса, Telegram сначала запрашивает у бота варианты доставки.
- Проверка перед оплатой. Перед списанием Telegram просит бота подтвердить заказ. На ответ — 10 секунд, иначе платёж отменяется.
- Оплата. Покупатель подтверждает её в окне: картой, Apple Pay, Google Pay или Stars.
- Подтверждение. Бот получает сообщение
successful_paymentи выполняет заказ.
Какой вариант подходит под ваш товар#
| Вариант | Чем платит покупатель | Для чего | Что берёт Telegram | Подключение |
|---|---|---|---|---|
| Telegram Stars | Баланс Stars | Цифровое: файлы, доступы, подписки | Продавец получает около $0,013 за Star | Ничего подключать не нужно |
| Карточный провайдер через @BotFather (Stripe, Freedom Pay и другие) | Карта, Apple Pay, Google Pay в окне Telegram | Физические товары и офлайн-услуги | Ничего, у провайдера своя комиссия | Токен провайдера |
| Stripe Connect (Tiny Shops) | Карта на защищённой странице Stripe | Физические товары в странах Stripe | Ничего, действует комиссия Stripe | Подключение Stripe из панели |
| TON | Любой TON-кошелёк | Крипто-аудитория, продажи за рубеж | Ничего | Адрес кошелька |
| Ручной заказ | Как договоритесь: наличные, перевод | Локальная доставка, оплата при получении | Ничего | Ничего |
Комиссии провайдеров зависят от страны и договора. Stripe публикует ставки на stripe.com/pricing, а, например, у Freedom Pay комиссия прописана в договоре. Точную цифру смотрите у своего провайдера, а не в таблице из блога.
Коротко о Telegram Stars#
Покупатели получают Stars через покупки в App Store и Google Play или в @PremiumBot и тратят их в ботах и Mini App. Для продавца цену задают условия для разработчиков ботов:
- Около $0,013 за Star — вознаграждение, выплату обрабатывает Fragment.
- $0,02 за Star, если потратить баланс на рекламу в Telegram Ads.
- До 21 дня проходит, прежде чем полученные Stars можно вывести или потратить на рекламу.
Stars — только целые числа, чаевые недоступны, а имя, телефон и адрес покупателя Telegram вместе с оплатой Stars не передаёт. Возврат делается через Bot API (refundStarPayment), а бот, который продаёт за Stars, обязан отвечать на команду /paysupport. Подробное сравнение с картами и таблица «Stars в доллары» — в статье Telegram Stars или Stripe.
Как принимать оплату в Telegram (общий путь)#
Если вы пишете бота сами, шаги по документации Telegram такие:
- Создайте бота в @BotFather. Пошагово — в нашем гайде по боту.
- Получите токен провайдера. В @BotFather:
/mybots→ ваш бот → Bot Settings → Payments. Выберите провайдера, пройдите у него регистрацию и скопируйте токен. Начните с тестового. Для Stars этот шаг не нужен: токен — пустая строка. - Выставляйте счета из кода через
sendInvoiceилиcreateInvoiceLinkв валюте, которую поддерживает провайдер. - Отвечайте на pre-checkout запрос в течение 10 секунд, а при гибкой доставке — и на запрос доставки.
- Обрабатывайте
successful_payment: отмечайте заказ оплаченным и отправляйте товар. - Пройдите чек-лист Telegram перед запуском: двухэтапная проверка на аккаунте владельца бота, команда
/termsс условиями, с которыми соглашается покупатель, команда/supportи готовность самим разбирать споры и чарджбэки. Затем замените тестовый токен на боевой (в нём есть:LIVE:).
Конструктор магазина берёт шаги 3–5 на себя — вместе с каталогом, корзиной и уведомлениями о заказах.
Как принимать оплату в Telegram через Tiny Shops#
Tiny Shops — конструктор магазинов в Telegram Mini App без кода. Магазин открывается в вашем собственном боте, а оформление заказа заканчивается в платёжном окне Telegram.
Карты через провайдера Telegram#
- Получите тестовый токен в @BotFather →
/mybots→ бот магазина → Bot Settings → Payments. Пошаговые инструкции для двух провайдеров: Stripe и Freedom Pay. - Откройте Настройки витрины → Заказы и платежи. В блоке Режим оформления выберите Платежи Telegram.
- Нажмите «Добавить провайдер». Заполните Название провайдера (любая подпись, например «Stripe»), вставьте токен в Токен провайдера, оставьте включёнными Тестовый режим и Активен и нажмите Сохранить провайдер.
- Проверьте валюту в блоке Валюта магазина. Она должна поддерживаться провайдером. Если платёж падает с ошибкой
PAYMENT_PROVIDER_INVALID, причина чаще всего в валюте. - Откройте Оформление заказа → Способы оплаты и убедитесь, что в списке есть Счёт Telegram. Если его нет — нажмите Добавить способ и добавьте. Статус сменится на «Подключено», когда появится активный провайдер.
- Выберите поля счёта. В блоке Настройка полей счёта включите Запрашивать имя, Запрашивать телефон, Запрашивать email или Запрашивать адрес доставки — что нужно. Гибкая стоимость доставки позволяет менять цену доставки в зависимости от адреса. Включить чаевые добавляет до 4 рекомендуемых сумм и Максимальную сумму чаевых.
- Сделайте тестовый заказ с телефона. С тестовым токеном Stripe подойдёт тестовая карта из документации Telegram:
4242 4242 4242 4242, любая будущая дата и любой CVC. - Запуститесь. Возьмите боевой токен в @BotFather, нажмите Редактировать провайдер, вставьте его, выключите Тестовый режим и сохраните.
Telegram Stars#
- В Настройках витрины → Заказы и платежи выберите Платежи Telegram и поставьте Валюту магазина — Telegram Stars (XTR). Появится блок «Telegram Stars включены»: ни токена, ни настроек не нужно.
- В Оформление заказа → Способы оплаты добавьте Telegram Stars.
- Укажите цены товаров в целых Stars.
У магазина одна валюта, поэтому он принимает либо Stars, либо карточного провайдера. Если вы продаёте и посылки, и цифровое — заведите два магазина в одном аккаунте.
Другие варианты#
Stripe Connect (карты на странице Stripe, выплаты на ваш Stripe), TON, Xendit для Индонезии, Филиппин и Малайзии и Ручной заказ настраиваются в Оформление заказа → Способы оплаты. Шаги для каждого — в статье способы оплаты в Telegram.
Apple Pay и Google Pay в Telegram#
Отдельно кошельки включать не нужно. Платёжное окно Telegram поддерживает Apple Pay и Google Pay, и они появляются, если их поддерживают ваш провайдер и устройство покупателя. Если покупатель не видит Apple Pay — уточните, доступен ли он у вашего провайдера в вашей стране. При оплате Stars кошельки не участвуют: покупатель платит с баланса Stars.
Сколько это стоит#
С платежей через провайдеров Telegram ничего не берёт, у провайдера своя комиссия. Tiny Shops стоит $0 на Free, $9,99 на Starter, $29 на Pro и $79 на Scale в месяц, и с каждого заказа берётся процент тарифа от суммы: 5%, 3%, 1,5% или 0,7%. Первые 50 заказов аккаунта бесплатны — один раз, а не каждый месяц. Продажи за Stars платят процент с первой продажи. На Pro процент — не больше $149 в месяц, на Scale — не больше $79. Подробнее на странице тарифов.
Если что-то не работает#
| Что происходит | Вероятная причина | Что сделать |
|---|---|---|
Ошибка PAYMENT_PROVIDER_INVALID | Провайдер не поддерживает валюту магазина | Смените Валюту магазина или уточните у провайдера список валют |
| Счёт Telegram — «Не подключено» | Нет активного провайдера | Добавьте его в Заказы и платежи и оставьте Активен |
| Stars не предлагаются при оформлении | Валюта магазина не XTR | Поставьте Валюту магазина — Telegram Stars (XTR) |
| Тестовые платежи проходят, настоящие — нет | Остался тестовый токен | Вставьте боевой токен и выключите Тестовый режим |
| Не приходят уведомления о заказах | Не выбрано, куда их слать | Настройте Уведомления о заказах и нажмите Отправить тестовое уведомление |
Частые вопросы#
Как работают платежи в Telegram? Бот выставляет счёт, Telegram показывает своё платёжное окно, покупатель платит картой, кошельком или Stars, а бот получает подтверждение и выполняет заказ. Карты идут через стороннего провайдера, Stars остаются внутри Telegram.
Берёт ли Telegram комиссию за платежи? С платежей через сторонних провайдеров — нет, комиссию берёт провайдер. За Stars продавец получает около $0,013 за Star — так записано в условиях Telegram для разработчиков.
Можно ли принимать Apple Pay в Telegram? Да, если его поддерживает ваш провайдер. Apple Pay и Google Pay появляются в платёжном окне Telegram без дополнительной настройки в магазине.
Можно ли продавать цифровые товары за карту в Telegram? Внутри бота или Mini App — нет. Telegram требует Stars для цифровых товаров и услуг и может скрыть от мобильных пользователей бота, который продаёт их за другие валюты.
Нужен ли разработчик? С конструктором — нет. В Tiny Shops вся настройка — это токен из @BotFather и несколько переключателей в панели.
Откройте магазин и примите первый платёж в Telegram на tiny-shops.com →
