Merchant API

Приём платежей в вашем боте — через API

Получите токен, создавайте инвойсы из кода и обрабатывайте вебхуки о каждой оплате. Песочница — чтобы проверить сценарий до продакшена.

Получить токен

Документация

8 монет · 16 сетей на одном балансе

Вебхук доставлен

Песочница

Начало работы

Как подключить Merchant API

От токена до первого вебхука — четыре шага.

Шаг 1

Получите токен

Создайте приложение в боте и получите ключ доступа к Merchant API.

Шаг 2

Создайте инвойс запросом

Один вызов API — сумма, монета, описание и адрес для вебхука.

Шаг 3

Покажите ссылку на оплату

Отдайте пользователю ссылку или кнопку — оплата проходит в Telegram.

Шаг 4

Обработайте вебхук

Получите событие об оплате и выдайте товар или доступ в своём сервисе.

Возможности

Платежи как часть вашего продукта

Инвойсы создаются запросом, статусы приходят вебхуком — остальное вы описываете сами.

Токен и песочница

Отдельный ключ для тестов: проверьте сценарий оплаты до того, как выпускать его на пользователей.

Инвойсы из кода

Создание, отмена и проверка статуса инвойса — обычными HTTP-запросами, без SDK.

Регулярные списания

Подписка как продукт: пользователь соглашается один раз, дальше списания идут по расписанию через Merchant API.

Вебхуки об оплате

Событие приходит сразу после оплаты и повторяется при сбое — состояние заказа не потеряется.

Документация и примеры

Описание методов, коды ошибок и готовые примеры запросов — в справочном центре.

Как это работает подробно — в справочном центре

8 монет · 16 сетей на одном балансе

GRAM

BTC

ETH

SOL

BNB

LTC

DOGE

TRX

USDTTRC-20 · ERC-20 · BEP-20 · TON · SOL

USDCERC-20 · BEP-20 · SOL

Ведёте канал? Продаёте в Telegram?

Посмотрите страницу глазами своей роли — набор возможностей изменится.

Для криэйторов Для продавцов Для разработчиков

Earn

Доход на балансе, о котором можно не думать

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

Ставка годовых Начисление каждый час

USDT 4% первые 500 USDT 1% свыше 500

GRAM 6% первые 300 GRAM 3% свыше 300

Выплата в кошелёк ежедневно в 00:30 UTC Вход и выход без комиссии

Пополнить Earn

Адрес совпадает

Безопасность

Проверка до отправки, а не после

Вывод — единственная операция, которая уводит деньги наружу. Вот что происходит вокруг того момента, когда вы нажимаете «Подтвердить».

Пока вы ещё не подтвердили
Адрес, сеть и memo — целиком Никаких «4f3a…9c2b»: видно, куда именно уходят деньги и в какой сети.
Список разрешённых адресов По желанию: вывод возможен только на адреса, которые вы добавили заранее.
PIN-код или Face ID Подтверждение требуется на каждый вывод, а не один раз за сессию.
Вы нажимаете «Подтвердить»
И даже после этого
Задержка на крупные суммы Вывод уходит не мгновенно — остаётся время передумать и отменить.
AML-проверка транзакции Операция проверяется до того, как средства уйдут получателю.
Уведомление о каждой операции Если что-то произошло без вас, вы узнаете об этом первым.

Раздел безопасности в справочном центре

Условия

Понятные условия

Сумма к списанию всегда видна до подтверждения — скрытых сборов нет.

Пополнение кошелька Зачисление после подтверждений сети

Без комиссии

Переводы по нику внутри Telegram Крипта не выходит в блокчейн — платить сети не за что

Без комиссии

Обмен внутри кошелька Курс, комиссия и итоговая сумма — на экране обмена

Видна до подтверждения

Вывод в блокчейн Адрес, сеть и memo проверяются до отправки

Только комиссия сети

Пополнить Earn и вывести из Earn Средства не блокируются на срок

Без комиссии

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

8 монет · 16 сетей — один баланс

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

TRC-20 · ERC-20 · BEP-20 · TON · SOL · BTC · LTC · DOGE

онлайн Живая поддержка в Telegram

Не пришёл вывод в TRC-20, что делать? Уже смотрю транзакцию — ответим здесь же, в чате.

@tgpayhelpbot

Вопросы

Частые вопросы

Коротко о кошельке, переводах, Earn и приёме платежей.

Нет. Кошелёк создаётся при первом запуске @tgpaycryptobot — логина, пароля и seed-фразы нет. Доступ привязан к вашему аккаунту Telegram.

Восемь монет и шестнадцать сетей: GRAM, BTC, ETH, SOL, BNB, LTC, DOGE и TRX, а также USDT в пяти сетях и USDC в трёх. Сеть выбирается при пополнении и выводе — у каждой свой адрес.

Укажите его ник — адрес не нужен, перевод проходит внутри кошелька и без комиссии сети. Если у получателя ещё нет кошелька, отправьте чек: он активирует его сам.

Вы переводите часть баланса в Earn, и начисления идут автоматически. Ставка двухуровневая: по USDT — 4% годовых на первые 500 USDT и 1% на сумму сверх этого, по GRAM — 6% на первые 300 GRAM и 3% сверх. Начисление идёт каждый час, выплата приходит в кошелёк ежедневно в 00:30 UTC. Пополнить Earn и вывести из Earn можно в любой момент и без комиссии.

Чек — это крипта ссылкой или QR-кодом. Он может быть рассчитан на одного получателя или на несколько активаций, защищён паролем, ограничен сроком действия, подписчиками ваших каналов или пользователями Telegram Premium. После создания чек можно поставить на паузу, изменить сумму и число активаций или удалить — остаток вернётся на баланс. Подробности — в справочном центре.

Да, в обе стороны: Telegram Stars и Telegram Premium покупаются за крипту, а свои Stars можно продать — зачисление в USDT происходит мгновенно. Курс показывается до подтверждения.

Переводы по нику проходят без комиссии сети, при выводе списывается комиссия сети. Комиссия обмена и итоговая сумма показываются до подтверждения, актуальные значения и минимумы — в приложении и в справочном центре.

Выставляйте инвойсы прямо в боте, а для автоматизации подключите Merchant API: инвойсы создаются запросом, а об оплате приходит вебхук. Описание методов есть в справочном центре.

Все ответы — в справочном центре Не нашли ответ — напишите в @tgpayhelpbot

Откройте кошелёк за минуту

Запустите @tgpaycryptobot в Telegram — кошелёк уже готов принимать крипту.

Открыть в Telegram

Смотрите как:

Персональный Для криэйторов Для продавцов Для разработчиков