Приём платежей в вашем боте — через API
Получите токен, создавайте счета из кода и обрабатывайте вебхуки о каждой оплате. Песочница — чтобы проверить сценарий до продакшена.
10 криптовалют · 8 сетей на одном балансе Есть MCP-сервер: интеграцию может сделать ваш ИИ-агент →
Как подключить Merchant API
От токена до первого вебхука — четыре шага. Подробнее о Merchant API →
Получите токен
Создайте приложение в боте и получите ключ доступа к Merchant API.
Создайте счёт запросом
Создайте счёт, указав сумму, криптовалюту и описание. Адрес вебхука задаётся отдельно в настройках приложения.
Покажите ссылку на оплату
Отдайте пользователю ссылку или кнопку — оплата проходит в Telegram.
Обработайте вебхук
Получите событие об оплате и выдайте товар или доступ в своём сервисе.
Интеграцию может сделать ваш ИИ-агент
У Merchant API есть MCP-сервер. Подключите его в совместимом клиенте агента: агент сможет прочитать документацию, запросить создание приложения, настроить вебхуки и помочь написать интеграцию. Вы подтверждаете приложение в Telegram, проверяете и тестируете результат.
- Шаг 1
Отправьте агенту промпт
- Шаг 2
Подтвердите приложение в Telegram
- Шаг 3
Завершите и протестируйте интеграцию
Connect the tgpay MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the TgPay Crypto Merchant API.
Платежи как часть вашего продукта
Счета создаются запросом, статусы приходят вебхуком — остальное вы описываете сами.
Токен и песочница
Отдельный ключ для тестов: проверьте сценарий оплаты до того, как выпускать его на пользователей.
Счета из кода
Создание, отмена и проверка статуса счёта — обычными 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-проверка транзакции Операция проверяется до того, как средства уйдут получателю.
- Уведомления о выводах Проверяйте уведомления о выводах в боте. Если операция вам незнакома, обратитесь в поддержку.
Понятные условия
Сумма к списанию всегда видна до подтверждения — скрытых сборов нет.
Актуальные комиссии и минимумы показываются в приложении. Полный список — в справочном центре.
Частые вопросы
Коротко о кошельке, переводах и приёме платежей.
