Перейти к основному содержимому

Принимать платежи в Telegram

Это решение для сервисов, которые продают через Telegram: бота, который отправляет ссылки на оплату в чат, или мини-приложения — веб-приложения, которое открывается внутри Telegram. Клиенты платят, не выходя из Telegram, бот подтверждает заказ в чате, а деньги поступают на ваш баланс Volet.com, откуда их можно вывести или заплатить партнёрам.

Подходит ли вам это решение​

Решение подойдёт, если вы:

  • Продаёте через бота услугу, которой пользуются вне Telegram: VPN, хостинг, SaaS-продукт, консультации, уроки или бронирование.
  • Продаёте физические товары через бота или мини-приложение.
  • Даёте пользователям пополнять баланс в вашем сервисе из Telegram.
  • Платите партнёрам или пользователям из денег, которые собирает бот.

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

Лучше выбрать другое решение, если:

Проверьте, что разрешает Telegram​

Telegram требует оплату в Telegram Stars за цифровые товары и услуги, которые продаются и используются внутри бота или мини-приложения. Продавать их за криптовалюту через платёжный шлюз нельзя. См. правила Telegram: payments for digital goods и Bot Developer Terms.

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

Что можно сделать​

Принимать платежи

Хранить и использовать деньги

  • Получайте каждый платёж в выбранной валюте, чем бы ни заплатил клиент; USD, USDT и USDC конвертируются 1:1. — Расчёты и автоконвертация
  • Платите партнёрам или пользователям с того же баланса или выводите средства на банковский счёт, карту или криптокошелёк. — Вывод и отправка средств

Кто за что отвечает​

Что нужноЧто видит и делаетЗа что отвечает
ВыВерифицированный аккаунт Volet.com, личный или бизнес, одобренный платёжный шлюз, бот, созданный в @BotFather, бэкендСоздаёт платёжный запрос, отправляет кнопку оплаты или открывает страницу оплаты, подтверждает заказ в чатеСоблюдение правил Telegram, свой продукт и его предоставление, возвраты, поддержка клиентов в боте
Ваши клиентыTelegram и криптокошелёк или аккаунт Volet.comНажимают кнопку в чате или платят в мини-приложении, видят страницу оплаты Volet.com с адресом вашего ботаОплата в сети, указанной на странице
Telegram—Размещает вашего бота и мини-приложениеСобственные правила платежей в ботах, включая Telegram Stars для цифровых товаров
Volet.com—Размещает страницу оплаты, отслеживает блокчейн, проверяет входящую криптовалюту (AML), конвертирует валюты, уведомляет ваш бэкендОбработка платежей и поддержка по вопросам платежей. Не предоставляет ваш продукт и не возвращает деньги вашим клиентам

Как движутся деньги​

  1. Клиент выбирает продукт в боте или мини-приложении.
  2. Ваш бэкенд создаёт платёжный запрос в Volet.com и сохраняет идентификатор пользователя Telegram вместе с заказом.
  3. Бот отправляет кнопку оплаты, или мини-приложение открывает страницу оплаты.
  4. Клиент платит в криптовалюте или с баланса Volet.com. При оплате криптовалютой Volet.com ждёт подтверждений в сети и проверяет платёж.
  5. Платёж зачисляется на ваш аккаунт в валюте расчётов и сразу доступен.
  6. Volet.com отправляет уведомление на ваш бэкенд; бот подтверждает заказ в чате и предоставляет продукт.

Настройка​

Шаг 1. Создайте платёжный шлюз​

Начните с Hosted Checkout: страница оплаты размещается на стороне Volet.com, работает внутри мини-приложения и поддерживает и криптоплатежи, и оплату с баланса. Выберите API, если хотите, чтобы экран оплаты был частью чата или мини-приложения. В настройках шлюза укажите адрес бота, включите цифровую подпись, решите, принимать ли недоплату и переплату, и задайте Status URL своего бэкенда. Одобрение обычно занимает несколько часов. См. Создание платёжного шлюза и Выбор способа интеграции.

Шаг 2. Создайте бота в Telegram​

  1. Откройте @BotFather в Telegram и создайте бота командой /newbot.
  2. Сохраните токен бота. Ваш бэкенд использует его, чтобы отправлять сообщения через Telegram Bot API.
  3. Чтобы открывать веб-интерфейс внутри Telegram, создайте мини-приложение в @BotFather и укажите URL своего веб-приложения. См. Telegram Mini Apps.

Для первого бота воспользуйтесь руководством Telegram.

Шаг 3. Покажите страницу оплаты​

  • В чате с ботом: отправьте сообщение с inline-кнопкой, которая открывает ваш URL оплаты. См. InlineKeyboardButton.
  • В мини-приложении: откройте страницу Hosted Checkout внутри мини-приложения или в браузере устройства с помощью Telegram.WebApp.openLink. См. Telegram Mini Apps.

Бэкенд создаёт платёжный запрос до открытия страницы, чтобы бот мог сопоставить платёж с заказом. См. Интеграция Hosted Checkout.

Шаг 4. Подтвердите заказ в чате​

Когда бэкенд получит уведомление о платеже и проверит его подпись, отправьте клиенту сообщение от бота и предоставьте продукт. Не рассчитывайте на то, что клиент вернётся в чат или мини-приложение.

Шаг 5. Примите первый платёж через бота​

У Volet.com нет песочницы, поэтому первый платёж будет настоящим: заплатите небольшую сумму через бота сами, с криптокошелька и с аккаунта Volet.com, и проверьте, что подтверждение приходит в чат. Интеграция небольшого бота занимает около дня. Дальше каждая продажа поступает на ваш баланс: выводите деньги, храните их в стейблкоинах или платите из них партнёрам. См. Вывод и отправка средств.

Вариант со своим кошельком​

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

  1. Мини-приложение подключает кошелёк клиента. Для подключения кошельков внутри мини-приложения Telegram требует TON Connect.
  2. Клиент подтверждает платёж в своём кошельке в USDT, USDC или нативном токене в поддерживаемой сети, включая TON.
  3. Платёж поступает на ваш кошелёк; бэкенд проверяет транзакцию в блокчейне, а бот подтверждает заказ в чате.
  4. Чтобы вывести деньги в фиат или заплатить партнёрам через Volet.com, отправьте часть криптовалюты на свой аккаунт Volet.com. Пополнение постоянного адреса своего криптокошелька в той же валюте проходит без комиссии Volet.com. См. Пополнение криптовалютой.

Что меняется: клиенты платят только с кошельков и сами оплачивают комиссии сети; автоматической конвертации нет; подключение настраивается индивидуально с отделом продаж, который также может адаптировать контракт под логику бота, например под подписки или доступ по токенам. См. Разработка смарт-контрактов на заказ. См. Приём некастодиальных криптоплатежей и Принимать криптовалюту на свой кошелёк.

Повседневная работа​

  • Подписки. Криптоплатежи не списываются автоматически каждый месяц. Дайте клиентам пополнять баланс в вашем сервисе и списывайте с него подписку по своему графику или отправляйте новую кнопку оплаты перед каждым периодом.
  • Опоздавшие и неполные платежи. Запрос на криптоплатёж действует 60 минут без конвертации и 15 минут с конвертацией. Опоздавший платёж возвращается клиенту или в некоторых случаях зачисляется вам. Настройки недоплаты и переплаты определяют, завершит ли заказ меньший или больший платёж. См. Обработка платежей.
  • «Я заплатил, а бот молчит». Прежде чем отвечать, проверьте статус заказа в бэкенде или через API: клиент мог заплатить в другой сети или после истечения запроса. См. Клиент говорит, что платёж подтверждён, а заказ не оплачен.
  • Возвраты. Volet.com не отменяет завершённые платежи. Возвращайте деньги клиентам сами, например переводом на их аккаунт Volet.com или криптовыплатой.
  • Поддельные боты. Сообщите клиентам, какой бот ваш, и никогда не просите их подключать кошелёк или платить вне вашего официального бота и мини-приложения.
  • Учёт. Скачивайте выписки и сохраняйте идентификатор пользователя Telegram и номер заказа с каждым платежом. См. Выписки.

Полезно знать​

  • Правила Telegram в приоритете. Цифровые товары, которыми пользуются внутри Telegram, оплачиваются в Telegram Stars. Если вы принимаете платежи с собственного кошелька клиента внутри мини-приложения (некастодиальные платежи), Telegram требует TON Connect для подключения кошелька. Платежи через Hosted Checkout или API не подключают кошелёк.
  • Проверка шлюза. Volet.com проверяет каждый новый шлюз и бота или сайт, который он обслуживает.
  • Проверка AML. Входящие криптоплатежи проверяются; обычно это укладывается в стандартное время обработки. См. Проверка транзакций.
  • Необратимые транзакции. Подтверждённые платежи в блокчейне нельзя отменить или вернуть.
  • Лимиты. Ваши текущие лимиты показываются до подтверждения каждой транзакции. См. Лимиты.

Стоимость​

КомиссияКто платитКогда
Комиссия за обработкуВы; для платежей с баланса её можно добавить к сумме для клиентаС каждого платежа
Комиссия сети за криптоплатёжВаш клиентПри оплате криптовалютой
КонвертацияВыКогда клиент платит в валюте, отличной от вашей валюты расчётов, кроме конвертации 1:1 между USD, USDT и USDC
Комиссии за вывод или выплатыВыКогда вы выводите средства или платите партнёрам

Платы за подключение и ежемесячной платы на стороне Volet.com нет. См. страницу комиссий для бизнеса. Точная комиссия всегда показывается до подтверждения.

По мере роста​

Актуальные предложения — на странице продукта криптовалютный платёжный шлюз.