Как принимать оплату в Telegram: полный гид по Google Pay, Apple Pay и Stars (2026)

Введение: принимать оплату в Telegram теперь проще простого#

Один из главных вопросов, которые задают новые владельцы Telegram-магазинов: «Как мне принимать оплату?» Отличная новость — в Telegram есть надёжная встроенная платёжная инфраструктура, и с Tiny Shops вы можете принимать Google Pay, Apple Pay и даже Telegram Stars без единой строки кода.

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

Что вы узнаете:

• Как работает нативная платёжная система Telegram
• Какие платёжные провайдеры поддерживаются (и как выбрать подходящий)
• Пошаговая настройка Google Pay и Apple Pay
• Как принимать Telegram Stars
• Настройка полей чекаута (имя, телефон, email, адрес доставки)
• Настройка чаевых для ваших клиентов
• Тестирование платёжного потока перед запуском
• Как обрабатываются и отслеживаются заказы

Как работают платежи в Telegram#

Прежде чем перейти к настройке, важно понять, как проходят платежи через Telegram. В отличие от традиционного e-commerce, где клиенты вводят данные карты на сайте, платежи в Telegram происходят нативно внутри приложения.

Платёжный поток#

Вот что происходит, когда клиент покупает товар в вашем Telegram-магазине:

1. Клиент нажимает «Оплатить» — видит товар с ценой и описанием
2. Telegram показывает инвойс — нативный экран оплаты с деталями заказа
3. Клиент выбирает способ оплаты — Google Pay, Apple Pay или вводит данные карты
4. Проверка перед оплатой — система проверяет, что заказ валиден, промокоды активны и бонусов достаточно
5. Обработка платежа — через настроенного платёжного провайдера
6. Подтверждение заказа — клиент получает подтверждение, вы — уведомление, заказ появляется в панели управления

Весь процесс занимает секунды, и клиент не покидает Telegram. Именно это делает коммерцию в Telegram такой мощной — нулевое трение.

Почему нативные платежи важны#

Традиционные интернет-магазины теряют 60-80% клиентов на этапе оплаты из-за сложностей — создание аккаунтов, ввод данных доставки, переход на внешние платёжные страницы. Telegram устраняет всё это:

• Клиенты уже авторизованы через Telegram
• Способы оплаты вроде Google Pay и Apple Pay требуют только одного касания
• Всё остаётся в знакомом интерфейсе Telegram
• Никаких редиректов, регистраций и восстановления паролей

Поддерживаемые способы оплаты#

Tiny Shops поддерживает три типа платежей для вашего магазина:

1. Google Pay#

Самый популярный мобильный платёжный метод для пользователей Android. Клиенты платят одним касанием, используя карты, сохранённые в Google-аккаунте.

• Работает на: Android-устройства, браузер Chrome
• Валюты: поддержка 100+ валют
• Опыт клиента: нажать → подтвердить отпечатком/лицом → готово

2. Apple Pay#

Оплата в одно касание для пользователей iPhone и iPad. Клиенты платят картами из Apple Wallet.

• Работает на: iPhone, iPad, Mac с Safari
• Валюты: поддержка 100+ валют
• Опыт клиента: двойное нажатие боковой кнопки → Face ID/Touch ID → готово

3. Telegram Stars#

Нативная виртуальная валюта Telegram. Stars идеально подходят для цифровых товаров, подписок и контента.

• Работает на: все платформы Telegram
• Валюта: XTR (Telegram Stars) — только целые единицы
• Опыт клиента: оплата балансом Stars прямо в Telegram
• Ключевое отличие: токен платёжного провайдера не нужен — Telegram всё обрабатывает сам
• Вывод средств: Stars можно конвертировать в криптовалюту TON (Toncoin)

“

Что выбрать? Для физических товаров и услуг используйте Google Pay/Apple Pay с платёжным провайдером. Для цифровых товаров рассмотрите Telegram Stars — минимальное трение.

Шаг 1: Получите токен платёжного провайдера#

Чтобы принимать Google Pay и Apple Pay, вам нужен токен платёжного провайдера от одного из поддерживаемых Telegram платёжных процессоров. Это уникальная строка, которая связывает ваш магазин с платёжным процессором.

Как получить токен#

1. Откройте Telegram и напишите @BotFather
2. Отправьте /mybots и выберите бота вашего магазина
3. Выберите «Payments»
4. Выберите платёжного провайдера из списка:
   • Stripe — широко доступен, поддержка 135+ валют
   • ЮKassa (ЮMoney) — популярен в России и странах СНГ
   • Сбербанк — для российских мерчантов
   • Tranzzo — для украинских мерчантов
   • И другие в зависимости от вашего региона
5. Следуйте инструкциям провайдера для создания мерчант-аккаунта
6. Вы получите токен провайдера — строку вида 123456789:TEST:XXXXX

“

Важно: Каждый провайдер даёт два токена — тестовый и боевой. Начните с тестового для проверки, затем переключитесь на боевой.

Выбор подходящего провайдера#

Шаг 2: Настройте платежи в панели управления#

Имея токен платёжного провайдера, настройка платежей в Tiny Shops займёт около 2 минут.

Перейдите в настройки платежей#

1. Войдите в панель управления Tiny Shops
2. Перейдите в Настройки магазина
3. Найдите раздел Режим оплаты

Выберите режим оплаты#

Tiny Shops предлагает два режима:

• Нативные платежи — клиенты платят прямо через Telegram через Google Pay, Apple Pay или карты. Рекомендуемый вариант.
• Ручной — заказы оформляются без оплаты; вы собираете оплату отдельно (удобно для оплаты при получении или особых платёжных договорённостей).

Выберите «Нативные платежи» для полноценного платёжного опыта.

Добавьте платёжного провайдера#

1. Нажмите «Добавить платёжного провайдера»
2. Заполните данные:
   • Название провайдера — понятное имя (например, «Stripe» или «Основной платёж»)
   • Токен провайдера — вставьте токен из BotFather
   • Тестовый режим — включите для тестирования (используйте тестовый токен), выключите для реальных транзакций
   • Активен — включите для активации провайдера
3. Нажмите Сохранить

Система проверит формат токена. Можно добавить несколько провайдеров, но обычно одного достаточно.

Для Telegram Stars#

Если хотите принимать Telegram Stars, настройка ещё проще — токен провайдера не нужен. Платежи Stars обрабатываются нативно Telegram. Просто убедитесь, что валюта вашего магазина установлена на XTR.

Шаг 3: Настройте поля оформления заказа#

Настройте, какую информацию вы собираете у клиентов при оплате. Это важно для доставки физических товаров или юридических требований.

Доступные поля#

В панели управления в разделе Настройки магазина → Конфигурация инвойса:

• Имя — полное имя клиента (рекомендуется для физических товаров)
• Номер телефона — для координации доставки
• Email — для подтверждений заказа и чеков
• Адрес доставки — обязательно для доставки физических товаров

Включайте или выключайте каждое поле по необходимости.

Гибкая доставка#

Включите «Гибкая доставка», если нужно рассчитывать стоимость доставки динамически на основе адреса клиента. При включении Telegram отправит запрос доставки перед завершением оплаты, позволяя вам предоставить варианты доставки с разными ценами.

Лучшие практики#

• Продаёте цифровые товары? Вероятно, не нужны имя, телефон или адрес доставки. Держите минимум для снижения трения при оплате.
• Продаёте физические товары локально? Включите имя и телефон. Подумайте, действительно ли нужен полный адрес доставки или можно договориться через чат Telegram.
• Продаёте международно? Включите все поля, включая адрес доставки.

“

Помните: Каждое дополнительное поле добавляет трение. Запрашивайте только то, что действительно необходимо.

Шаг 4: Настройте чаевые (необязательно)#

Tiny Shops поддерживает чаевые от клиентов — отличная функция для сервисных бизнесов, ресторанов и магазинов с доставкой.

Как работают чаевые#

• Клиенты видят предложенные суммы чаевых при оплате
• Чаевые добавляются сверх суммы заказа
• Вы можете установить максимальную сумму чаевых и до 4 предложенных сумм
• Чаевые отслеживаются отдельно в записях заказов

Настройка чаевых#

1. Перейдите в Настройки магазина → Конфигурация инвойса
2. Найдите раздел Чаевые
3. Установите Максимальную сумму чаевых (в минимальных единицах валюты — копейках для RUB, центах для USD)
4. Добавьте Предложенные суммы чаевых — до 4 вариантов

Пример для кофейни (RUB):

• Предложенные чаевые: 50₽, 100₽, 150₽, 200₽
• Максимум: 500₽

“

Заметка: Чаевые не поддерживаются для Telegram Stars (XTR). Эта функция работает только с обычными валютами.

Шаг 5: Протестируйте платёжный поток#

Перед запуском обязательно протестируйте полный платёжный поток. Вот как:

Использование тестового режима#

1. Убедитесь, что у платёжного провайдера включён Тестовый режим в панели управления
2. Используйте тестовый токен провайдера из BotFather (не боевой)
3. Откройте бота вашего магазина в Telegram
4. Добавьте товар в корзину и перейдите к оплате
5. Используйте тестовые номера карт от вашего платёжного процессора:
   • Тестовая карта Stripe: 4242 4242 4242 4242 (любой будущий срок действия, любой CVC)
   • Другие провайдеры: проверьте их документацию для тестовых карт

Что проверить#

Во время тестирования убедитесь, что:

• ✅ Товары показывают корректные цены
• ✅ На экране оплаты отображается название вашего магазина
• ✅ Обязательные поля появляются (имя, телефон и т.д.)
• ✅ Варианты чаевых отображаются корректно (если настроены)
• ✅ Оплата проходит успешно с тестовой картой
• ✅ Вы получаете уведомление в группе уведомлений
• ✅ Заказ появляется в панели управления с корректными деталями
• ✅ Клиент получает сообщение-подтверждение

Переход на боевой режим#

После завершения тестирования:

1. Вернитесь в Настройки магазина
2. Обновите токен платёжного провайдера на боевой токен из BotFather
3. Выключите Тестовый режим
4. Сохраните изменения

Ваш магазин теперь принимает реальные платежи!

Шаг 6: Обработка заказов#

Когда платёж успешен, вот что происходит за кулисами:

Автоматическая обработка#

1. Создание заказа — со статусом «В ожидании», содержащий все товары, цены и данные клиента
2. Применение промокодов — если клиент использовал промокод, он проверяется и записывается
3. Списание бонусов — если клиент применил бонусы кэшбэка, они вычитаются из баланса
4. Начисление кэшбэка — клиент получает кэшбэк в соответствии со своим уровнем (если в магазине включён кэшбэк)
5. Отправка уведомлений — и вы, и клиент получаете сообщения в Telegram с деталями заказа
6. Учёт чаевых — если клиент оставил чаевые, они записываются отдельно от суммы заказа

Управление заказами#

В панели управления вы можете:

• Просматривать все заказы с фильтрацией и поиском
• Видеть детали заказа: товары, цены, способ оплаты и данные клиента
• Обновлять статус заказа (В ожидании → В обработке → Отправлен → Доставлен)
• Отслеживать ID платежей для сверки с платёжным провайдером
• Просматривать начисленный кэшбэк и использованные промокоды по каждому заказу

Работа с несколькими валютами#

Tiny Shops поддерживает 100+ валют, что позволяет легко продавать международно.

Установка валюты магазина#

1. Перейдите в Настройки магазина
2. Выберите валюту магазина (например, USD, RUB, EUR, BYN)
3. Все цены товаров и чекаут будут в этой валюте

Совместимость валют и провайдеров#

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

Цены в минимальных единицах#

API платежей Telegram работает с минимальными единицами валюты:

• USD: центы (100 = $1.00)
• RUB: копейки (100 = 1₽)
• EUR: центы (100 = €1.00)
• XTR (Stars): целые единицы (1 = 1 Star)

Tiny Shops выполняет конвертацию автоматически — вы просто вводите цены в обычном формате в панели управления.

Безопасность и доверие#

Платежи в Telegram безопасны по своей природе:

• Сквозное шифрование платёжных данных
• Соответствие PCI DSS — платёжные провайдеры обрабатывают данные карт; они никогда не попадают на ваши серверы или серверы Tiny Shops
• Проверка перед оплатой — каждый заказ проверяется до обработки платежа
• Доверенный интерфейс Telegram — клиенты видят знакомый экран оплаты Telegram

Что насчёт возвратов?#

Возвраты обрабатываются через панель управления вашего платёжного провайдера (например, Stripe Dashboard для платежей Stripe). Bot API Telegram также поддерживает метод refundStarPayment для транзакций на основе Stars.

Промокоды и бонусы при оплате#

Tiny Shops интегрирует промо-инструменты прямо в платёжный поток:

Промокоды

• Клиенты могут ввести промокод при оплате
• Поддерживаются скидки в процентах и фиксированной суммой
• Настраиваемые лимиты использования и сроки действия
• Нельзя использовать на товары со скидкой
• Взаимоисключающие с бонусами — клиенты используют что-то одно

Кэшбэк-бонусы#

• Клиенты накапливают бонусы от предыдущих покупок
• Могут применить бонусы при оплате — до 50% от суммы заказа (на товары без скидки)
• Бонусы списываются атомарно при обработке платежа
• Предотвращение двойного списания через транзакции базы данных

Часто задаваемые вопросы#

Какой процент Tiny Shops берёт с моих продаж?#

0%. Tiny Shops не берёт комиссию платформы с транзакций. Вы платите только стандартную комиссию платёжного провайдера (обычно 2-3%).

Могу ли я принимать и Google Pay, и Apple Pay?#

Да! Оба поддерживаются через один и тот же токен платёжного провайдера. Telegram автоматически показывает подходящий вариант оплаты в зависимости от устройства клиента.

Нужен ли отдельный провайдер для Telegram Stars?#

Нет. Telegram Stars вообще не требуют токена провайдера — Telegram обрабатывает платёж напрямую.

Что происходит при неудачном платеже?#

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

Можно ли подключить несколько платёжных провайдеров?#

Да. Вы можете добавить несколько провайдеров в панели управления. Система выберет совместимого провайдера на основе валюты магазина.

Как быстро я получу деньги?#

Зависит от платёжного провайдера. Stripe обычно переводит средства в течение 2-7 рабочих дней. Другие провайдеры могут быть быстрее. Telegram Stars можно конвертировать в TON и вывести.

Безопасно ли это для моих клиентов?#

Абсолютно. Платёжные данные обрабатываются исключительно Telegram и платёжным провайдером. Номера карт не проходят через Tiny Shops. Система соответствует PCI DSS через платёжных провайдеров.

Можно ли принимать платежи в моей местной валюте?#

Да, Tiny Shops поддерживает 100+ валют. Просто установите предпочтительную валюту в настройках магазина и убедитесь, что ваш платёжный провайдер её поддерживает.

Заключение

Принимать платежи в Telegram-магазине просто с Tiny Shops:

1. Получите токен провайдера у @BotFather
2. Настройте в панели управления — займёт 2 минуты
3. Установите поля чекаута для нужной информации
4. Протестируйте тестовой транзакцией перед запуском
5. Начните продавать — каждый платёж обрабатывается безопасно через Telegram

С нулевой комиссией платформы, нативной поддержкой Google Pay и Apple Pay и безбарьерным чекаутом в Telegram ваши клиенты могут перейти от просмотра к покупке за пару касаний.

Готовы начать принимать платежи? Настройте Telegram-магазин и начните получать оплату уже сегодня.