Stripe работает с Telegram двумя способами. Можно подключить Stripe к Telegram-боту как платёжного провайдера через @BotFather — тогда покупатель платит в платёжном окне самого Telegram. А можно подключить аккаунт Stripe напрямую через Stripe Connect — тогда оплата проходит на защищённой странице Stripe. В этом гайде — чем отличаются эти способы и как пройти каждый: от аккаунта Stripe до тестовой карты и первого боевого заказа в Telegram-магазине на Tiny Shops.
Stripe — для физических товаров и офлайн-услуг. Цифровые товары внутри Telegram оплачиваются только в Stars: подробнее в статье Telegram Stars или Stripe. Общая картина — в статьях как работают платежи в Telegram и способы оплаты в Telegram.
Два способа подключить Stripe к Telegram#
| Stripe через @BotFather | Stripe Connect | |
|---|---|---|
| Где платит покупатель | В платёжном окне Telegram поверх чата | На странице оплаты Stripe, которая открывается из магазина |
| Что вставлять | Токен провайдера из BotFather | Ничего: вы входите в Stripe |
| Другие способы оплаты | Могут работать рядом | Карта становится единственным способом оплаты |
| Процент Tiny Shops | Списывается вместе с тарифом | Удерживается из платежа в момент оплаты |
| Где настраивается | Настройки витрины → Заказы и платежи | Оформление заказа → Способы оплаты |
В обоих случаях деньги приходят на ваш собственный аккаунт Stripe, а Stripe берёт свою комиссию за обработку. Telegram с платежей через провайдеров комиссию не берёт.
Что понадобится#
- Telegram-бот, подключённый к магазину на Tiny Shops.
- Аккаунт Stripe в стране вашего бизнеса с пройденной проверкой — до боевых платежей.
- Валюта магазина, которую принимает ваш Stripe (USD, EUR, GBP и т. д.), не
XTR.
Способ 1: Stripe как платёжный провайдер Telegram (BotFather)#
Шаг 1 — Получите токен Stripe в BotFather#
- Откройте @BotFather →
/mybots→ бот магазина. - Нажмите Bot Settings → Payments.
- Выберите Stripe TEST MODE и, если попросят, завершите подключение к Stripe.
- Скопируйте тестовый токен провайдера.
Позже вы вернётесь за Stripe LIVE MODE. В боевом токене посередине есть :LIVE: (например, 123:LIVE:XXXX). Никому его не показывайте.
API-ключи Stripe для этого способа не нужны: токен, который использует магазин, выдаёт подключение Stripe в BotFather.
Шаг 2 — Вставьте токен в Tiny Shops#
- В панели откройте Настройки витрины → Заказы и платежи.
- В Режиме оформления выберите Платежи Telegram.

- Нажмите Добавить провайдер и заполните:
- Название провайдера — впишите
Stripe. Это ваша подпись: готового пункта Stripe в списке нет. - Токен провайдера — токен Stripe TEST MODE.
- Тестовый режим — включён на время тестов.
- Активен — включён, чтобы оформление заказа могло его использовать.
- Название провайдера — впишите

- Нажмите Сохранить провайдер. В строке появятся отметки Тестовый режим и Активен и кнопки Редактировать провайдер и Удалить провайдер.

- Проверьте Валюту магазина на той же странице: она должна поддерживаться вашим аккаунтом Stripe.
- Откройте Оформление заказа → Способы оплаты и убедитесь, что в списке есть Счёт Telegram. Если нет — нажмите Добавить способ и добавьте его.
Шаг 3 — Сделайте тестовый заказ#
Откройте магазин в Telegram, добавьте товар и оплатите тестовой картой Stripe:
| Поле | Тестовое значение |
|---|---|
| Карта | 4242 4242 4242 4242 |
| Срок | любая будущая дата |
| CVC | любые 3 цифры |
В Stripe TEST MODE настоящие карты не проходят. Актуальный список тестовых карт — у Stripe. Убедитесь, что платёж виден в кабинете Stripe (в тестовом режиме), а не только в Заказах.
Шаг 4 — Запуск#
- Пройдите проверку в Stripe, чтобы аккаунт мог принимать боевые платежи.
- В BotFather → Payments подключите Stripe LIVE MODE и скопируйте боевой токен.
- В Tiny Shops нажмите Редактировать провайдер, вставьте боевой токен, выключите Тестовый режим, оставьте Активен и нажмите Сохранить провайдер.
- Сделайте небольшой реальный заказ и проверьте его в боевом кабинете Stripe.
Перед запуском пройдите и чек-лист Telegram: двухэтапная проверка на аккаунте владельца бота, команды /terms и /support, готовность разбирать споры и чарджбэки.
Способ 2: Stripe Connect#
- Откройте Оформление заказа → Способы оплаты и найдите карточку Stripe Connect.
- В поле В какой стране зарегистрирован ваш бизнес? выберите страну бизнеса. Stripe закрепляет её при создании аккаунта, поэтому указывайте страну регистрации, а не то, где вы сейчас.
- Нажмите Подключить Stripe и пройдите регистрацию в Stripe.
- Дождитесь статуса Можно принимать карты. Если Stripe нужны ещё данные, в карточке будет кнопка Продолжить настройку Stripe.
После подключения Stripe Connect становится единственным способом оплаты в магазине, остальные способы отключатся. В карточке видна Комиссия Tiny Shops с продажи, комиссия Stripe — сверху. Если Stripe Connect недоступен для страны вашего бизнеса, используйте способ 1.
Комиссии#
- Telegram: с платежей через провайдеров комиссии нет.
- Stripe: своя комиссия за обработку, зависит от страны, карты и договора. Смотрите stripe.com/pricing и свой кабинет Stripe.
- Tiny Shops: процент тарифа с каждого заказа — 7% на Free, 3% на Starter ($9,99 в месяц), 1,5% на Pro ($29), 0,7% на Scale ($79). Первые $100 продаж аккаунта — без комиссии, один раз, а не каждый месяц. Со Stripe Connect процент удерживается в момент оплаты, с токеном из BotFather — списывается вместе с тарифом. Подробнее — на странице тарифов.
Частые вопросы#
Поддерживает ли Telegram Stripe? Да. Stripe — один из платёжных провайдеров Telegram: в @BotFather → Bot Settings → Payments есть Stripe TEST MODE и Stripe LIVE MODE.
Нужны ли API-ключи Stripe? Нет. Для способа 1 нужен только токен из BotFather, для способа 2 вы входите в Stripe прямо из панели.
Почему платёж падает с ошибкой PAYMENT_PROVIDER_INVALID?
Обычно валюта магазина не поддерживается вашим аккаунтом Stripe. Смените Валюту магазина или проверьте настройки Stripe.
Можно ли продавать через Stripe цифровые товары в Telegram? Нет. Для цифровых товаров и услуг внутри ботов и Mini App Telegram требует Stars.
Будут ли работать Apple Pay и Google Pay? Платёжное окно Telegram поддерживает Apple Pay и Google Pay, и они появляются, если их поддерживают Stripe и устройство покупателя. В магазине ничего включать не нужно.
Источники#
- Telegram Bot Payments (Stripe TEST MODE и LIVE MODE)
- Telegram Stars для цифровых товаров
- Тарифы Stripe · Тестовые карты Stripe
- Документация Tiny Shops: Telegram Payments
Продаёте в Центральной Азии? Подключите Freedom Pay. Откройте магазин на tiny-shops.com →
