Журнал
Stripe

Stripe в Telegram: как подключить к магазину

Stripe и Telegram по шагам: токен Stripe в BotFather или Stripe Connect, подключение к Telegram-магазину, тестовая карта 4242 и запуск боевых платежей.

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 через @BotFatherStripe Connect
Где платит покупательВ платёжном окне Telegram поверх чатаНа странице оплаты Stripe, которая открывается из магазина
Что вставлятьТокен провайдера из BotFatherНичего: вы входите в Stripe
Другие способы оплатыМогут работать рядомКарта становится единственным способом оплаты
Процент Tiny ShopsСписывается вместе с тарифомУдерживается из платежа в момент оплаты
Где настраиваетсяНастройки витрины → Заказы и платежиОформление заказа → Способы оплаты

В обоих случаях деньги приходят на ваш собственный аккаунт Stripe, а Stripe берёт свою комиссию за обработку. Telegram с платежей через провайдеров комиссию не берёт.

Что понадобится#

  1. Telegram-бот, подключённый к магазину на Tiny Shops.
  2. Аккаунт Stripe в стране вашего бизнеса с пройденной проверкой — до боевых платежей.
  3. Валюта магазина, которую принимает ваш Stripe (USD, EUR, GBP и т. д.), не XTR.

Способ 1: Stripe как платёжный провайдер Telegram (BotFather)#

Шаг 1 — Получите токен Stripe в BotFather#

  1. Откройте @BotFather → /mybots → бот магазина.
  2. Нажмите Bot Settings → Payments.
  3. Выберите Stripe TEST MODE и, если попросят, завершите подключение к Stripe.
  4. Скопируйте тестовый токен провайдера.

Позже вы вернётесь за Stripe LIVE MODE. В боевом токене посередине есть :LIVE: (например, 123:LIVE:XXXX). Никому его не показывайте.

API-ключи Stripe для этого способа не нужны: токен, который использует магазин, выдаёт подключение Stripe в BotFather.

Шаг 2 — Вставьте токен в Tiny Shops#

  1. В панели откройте Настройки витрины → Заказы и платежи.
  2. В Режиме оформления выберите Платежи Telegram.
Заказы и платежи — выбран режим Платежи Telegram
Заказы и платежи — выбран режим Платежи Telegram
  1. Нажмите Добавить провайдер и заполните:
    • Название провайдера — впишите Stripe. Это ваша подпись: готового пункта Stripe в списке нет.
    • Токен провайдера — токен Stripe TEST MODE.
    • Тестовый режим — включён на время тестов.
    • Активен — включён, чтобы оформление заказа могло его использовать.
Форма «Добавить провайдер»: название Stripe, скрытый токен, тестовый режим и «Активен»
Форма «Добавить провайдер»: название Stripe, скрытый токен, тестовый режим и «Активен»
  1. Нажмите Сохранить провайдер. В строке появятся отметки Тестовый режим и Активен и кнопки Редактировать провайдер и Удалить провайдер.
Сохранённый провайдер Stripe с отметками «Тестовый режим» и «Активен»
Сохранённый провайдер Stripe с отметками «Тестовый режим» и «Активен»
  1. Проверьте Валюту магазина на той же странице: она должна поддерживаться вашим аккаунтом Stripe.
  2. Откройте Оформление заказа → Способы оплаты и убедитесь, что в списке есть Счёт Telegram. Если нет — нажмите Добавить способ и добавьте его.

Шаг 3 — Сделайте тестовый заказ#

Откройте магазин в Telegram, добавьте товар и оплатите тестовой картой Stripe:

ПолеТестовое значение
Карта4242 4242 4242 4242
Сроклюбая будущая дата
CVCлюбые 3 цифры

В Stripe TEST MODE настоящие карты не проходят. Актуальный список тестовых карт — у Stripe. Убедитесь, что платёж виден в кабинете Stripe (в тестовом режиме), а не только в Заказах.

Шаг 4 — Запуск#

  1. Пройдите проверку в Stripe, чтобы аккаунт мог принимать боевые платежи.
  2. В BotFather → Payments подключите Stripe LIVE MODE и скопируйте боевой токен.
  3. В Tiny Shops нажмите Редактировать провайдер, вставьте боевой токен, выключите Тестовый режим, оставьте Активен и нажмите Сохранить провайдер.
  4. Сделайте небольшой реальный заказ и проверьте его в боевом кабинете Stripe.

Перед запуском пройдите и чек-лист Telegram: двухэтапная проверка на аккаунте владельца бота, команды /terms и /support, готовность разбирать споры и чарджбэки.

Способ 2: Stripe Connect#

  1. Откройте Оформление заказа → Способы оплаты и найдите карточку Stripe Connect.
  2. В поле В какой стране зарегистрирован ваш бизнес? выберите страну бизнеса. Stripe закрепляет её при создании аккаунта, поэтому указывайте страну регистрации, а не то, где вы сейчас.
  3. Нажмите Подключить Stripe и пройдите регистрацию в Stripe.
  4. Дождитесь статуса Можно принимать карты. Если 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 и устройство покупателя. В магазине ничего включать не нужно.

Источники#

Продаёте в Центральной Азии? Подключите Freedom Pay. Откройте магазин на tiny-shops.com →

Читать дальше

Freedom pay

Freedom Pay в Телеграм: подключение к магазину

Как подключить Freedom Pay (бывший PayBox) к Телеграм-боту: токен в BotFather, магазин, тест и запуск. Для продавцов из Кыргызстана, Казахстана и Узбекистана.

Канал

Новые статьи — сначала в Telegram.
Без спама и «лайфхаков роста».