Принимать платежи в Telegram
Это решение для сервисов, которые продают через Telegram: бота, который отправляет ссылки на оплату в чат, или мини-приложения — веб-приложения, которое открывается внутри Telegram. Клиенты платят, не выходя из Telegram, бот подтверждает заказ в чате, а деньги поступают на ваш баланс Volet.com, откуда их можно вывести или заплатить партнёрам.
Подходит ли вам это решение
Решение подойдёт, если вы:
- Продаёте через бота услугу, которой пользуются вне Telegram: VPN, хостинг, SaaS-продукт, консультации, уроки или бронирование.
- Продаёте физические товары через бота или мини-приложение.
- Даёте пользователям пополнять баланс в вашем сервисе из Telegram.
- Платите партнёрам или пользователям из денег, которые собирает бот.
Подойдёт и личный аккаунт. Бизнес-аккаунт нужен, только если платежи должны идти от имени компании или ваши объёмы превышают лимиты личного аккаунта. См. Выбор личного или бизнес-аккаунта.
Лучше выбрать другое решение, если:
- Вы продаёте цифровые товары или контент, которыми пользуются внутри самого Telegram: платные посты, игровые предметы, доступ в закрытый канал. Для них Telegram требует собственную валюту — Telegram Stars; см. Проверьте, что разрешает Telegram ниже.
- Вы ведёте бота в одиночку и только начинаете. См. Запустить платный онлайн-сервис; всё, что сказано о Telegram на этой странице, тоже действует.
- Вы также платите подрядчикам, партнёрам или пользователям с того же баланса. О выплатах см. Пополнения и выводы для пользователей.
Проверьте, что разрешает Telegram
Telegram требует оплату в Telegram Stars за цифровые товары и услуги, которые продаются и используются внутри бота или мини-приложения. Продавать их за криптовалюту через платёжный шлюз нельзя. См. правила Telegram: payments for digital goods и Bot Developer Terms.
Платёжный шлюз, такой как Volet.com, подходит для всего остального: услуг, которыми пользуются вне Telegram, физических товаров, пополнения баланса в вашем собственном сервисе, выплат партнёрам и расчётов между компаниями.
Что можно сделать
Принимать платежи
- Принимайте от клиентов криптовалюту с любого внешнего кошелька, например USDT в сети Tron или TON, или оплату с баланса Volet.com. Тем, кто платит криптовалютой, аккаунт Volet.com не нужен. — Приём кастодиальных криптоплатежей, Приём платежей от пользователей Volet.com
- Открывайте страницу Hosted Checkout внутри мини-приложения: она загружается во встроенном браузере приложения с вашим логотипом и фирменными цветами. — Создание платёжного шлюза
- Создайте собственный экран оплаты в чат е или мини-приложении на API и сами показывайте клиентам адрес и сумму. — Интеграция по API
- Укажите в шлюзе адрес своего бота, например
https://t.me/example_bot: клиенты видят его на странице оплаты. — Шаг 3. Настройте параметры - Заранее выбирайте способ оплаты и язык страницы оплаты для своей аудитории. — Расширенная настройка
Хранить и использовать деньги
- Получайте каждый платёж в выбранной валюте, чем бы ни заплатил клиент; USD, USDT и USDC конвертируются 1:1. — Расчёты и автоконвертация
- Платите партнёрам или пользователям с того же баланса или выводите средства на банковский счёт, карту или криптокошелёк. — Вывод и отправка средств
Кто за что отвечает
| Что нужно | Что видит и делает | За что отвечает | |
|---|---|---|---|
| Вы | Верифицированный аккаунт Volet.com, личный или бизнес, одобренный платёжный шлюз, бот, созданный в @BotFather, бэкенд | Создаёт платёжный запрос, отправляет кнопку оплаты или открывает страницу оплаты, подтверждает заказ в чате | Соблюдение правил Telegram, свой продукт и его предоставление, возвраты, поддержка клиентов в боте |
| Ваши клиенты | Telegram и криптокошелёк или аккаунт Volet.com | Нажимают кнопку в чате или платят в мини-приложении, видят страницу оплаты Volet.com с адресом вашего бота | Оплата в сети, указанной на странице |
| Telegram | — | Размещает вашего бота и мини-приложение | Собственные правила платежей в ботах, включая Telegram Stars для цифровых товаров |
| Volet.com | — | Размещает страницу оплаты, отслеживает блокчейн, проверяет входящую криптовалюту (AML), конвертирует валюты, уведомляет ваш бэкенд | Обработка платежей и поддержка по вопросам платежей. Не предоставляет ваш продукт и не возвращает деньги вашим клиентам |
Как движутся деньги
- Клиент выбирает продукт в боте или мини-приложении.
- Ваш бэкенд создаёт платёжный запрос в Volet.com и сохраняет идентификатор пользователя Telegram вместе с заказом.
- Бот отправляет кнопку оплаты, или мини-приложение открывает страницу оплаты.
- Клиент платит в криптовалюте или с баланса Volet.com. При оплате криптовалютой Volet.com ждёт подтверждений в сети и проверяет платёж.
- Платёж зачисляется на ваш аккаунт в валюте расчётов и сразу доступен.
- Volet.com отправляет уведомление на ваш бэкенд; бот подтверждает заказ в чате и предоставляет продукт.
Настройка
Шаг 1. Создайте платёжный шлюз
Начните с Hosted Checkout: страница оплаты размещается на стороне Volet.com, работает внутри мини-приложения и поддерживает и криптоплатежи, и оплату с баланса. Выберите API, если хотите, чтобы экран оплаты был частью чата или мини-приложения. В настройках шлюза укажите адрес бота, включите цифровую подпись, решите, принимать ли недоплату и переплату, и задайте Status URL своего бэкенда. Одобрение обычно занимает несколько часов. См. Создание платёжного шлюза и Выбор способа интеграции.
Шаг 2. Создайте бота в Telegram
- Откройте @BotFather в Telegram и создайте бота командой
/newbot. - Сохраните токен бота. Ваш бэкенд использует его, чтобы отправлять сообщения через Telegram Bot API.
- Чтобы открывать веб-интерфейс внутри Telegram, создайте мини-приложение в @BotFather и укажите URL своего веб-приложения. См. Telegram Mini Apps.
Для первого бота воспользуйтесь руководством Telegram.
Шаг 3. Покажите страницу оплаты
- В чате с ботом: отправьте сообщение с inline-кнопкой, которая открывает ваш URL оплаты. См. InlineKeyboardButton.
- В мини-приложении: откройте страницу Hosted Checkout внутри мини-приложения или в браузере устройства с помощью
Telegram.WebApp.openLink. См. Telegram Mini Apps.
Бэкенд создаёт платёжный запрос до открытия страницы, чтобы бот мог сопоставить платёж с заказом. См.