Merchant API

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

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

10 криптовалют · 8 сетей на одном балансе Есть MCP-сервер: интеграцию может сделать ваш ИИ-агент →
Экран Merchant API: приложения и подключение ИИ-агента
Вебхук: счёт оплачен
Тестовая сеть
Начало работы

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

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

Шаг 1

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

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

Шаг 2

Создайте счёт запросом

Создайте счёт, указав сумму, криптовалюту и описание. Адрес вебхука задаётся отдельно в настройках приложения.

Шаг 3

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

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

Шаг 4

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

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

ИИ-агент

Интеграцию может сделать ваш ИИ-агент

У Merchant API есть MCP-сервер. Подключите его в совместимом клиенте агента: агент сможет прочитать документацию, запросить создание приложения, настроить вебхуки и помочь написать интеграцию. Вы подтверждаете приложение в Telegram, проверяете и тестируете результат.

  1. Шаг 1

    Отправьте агенту промпт

  2. Шаг 2

    Подтвердите приложение в Telegram

  3. Шаг 3

    Завершите и протестируйте интеграцию

Как это работает, промпты для клиентов и что может токен агента →
Промпт для агента с MCP
Connect the MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the Merchant API.
Возможности

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

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

Токен и тестовая сеть

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

Счета из кода

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

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

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

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

События об оплате отправляются на адрес вебхука с повторными попытками при сбое доставки. Статус счёта также можно проверить через API.

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

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

10 криптовалют · 8 сетей на одном балансе

GRAM BTC ETH SOL BNB LTC DOGE TRX
USDTTRC-20 · ERC-20 · BEP-20 · TON · SOL USDCERC-20 · BEP-20 · SOL

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

Выберите свою роль — на странице появятся подходящие вам возможности.

Для авторов Для продавцов Для разработчиков
Экран подтверждения вывода
Адрес корректен
Безопасность

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

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

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

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

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

Пополнение кошелька Зачисление после подтверждений сети. Сумма ниже минимума сети не зачисляется; первый адрес в сети бесплатный, каждый следующий — $5. Без комиссии
Переводы по нику внутри Telegram Крипта не выходит в блокчейн — платить сети не за что Без комиссии
Обмен внутри кошелька Комиссия уже в курсе; курс и итоговая сумма — на экране обмена Видна до подтверждения
Вывод в блокчейн Формат адреса проверяется до отправки; адрес, сеть и memo — на экране подтверждения Комиссия видна до подтверждения

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

USDT GRAM BTC ETH SOL BNB LTC DOGE
10 криптовалют · 8 сетей — один баланс

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

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

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

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

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

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

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

Укажите его @username или числовой Telegram ID — адрес не нужен, перевод проходит внутри кошелька без комиссии сети. Если получатель ещё не открывал TgPay Crypto, перевод дождётся его и зачислится, когда он впервые откроет бота; не заберёт за 30 дней — средства вернутся вам. Можно отправить и чек — ссылку, по которой средства заберёт тот, кто откроет её первым.

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

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

Создавайте счета в приложении. Для автоматизации подключите Merchant API: создавайте счета запросом и получайте вебхуки об оплате. Методы описаны в документации API.

Не нашли ответ? Напишите в поддержку в приложении

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

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

Ваша роль: