Мерчант API (Разработчикам)
API для мерчантов: приложения, счета, переводы и вебхуки.
Что такое Merchant API
Merchant API — это платёжный API приложения для бизнеса и ботов. Вы создаёте приложение, получаете API-токен и с его помощью выставляете счета пользователям Telegram, отправляете им выплаты и проверяете баланс — всё из собственного кода.
Как начать работу с API
Создайте приложение в Mini App, один раз скопируйте его API-токен и начинайте вызывать API. Вся настройка находится в разделе Ещё → Merchant API.
Как подключить ИИ-агента
Дайте своему кодинг-агенту один адрес — https://app.tgpaycrypto.com/mcp — и он соберёт приём платежей за вас: изучит документацию API, создаст мерчант-приложение, настроит вебхуки и напишет код. От вас нужно одно подтверждение в боте, одной кнопкой. Ни терминала, ни API-токена, который надо переносить руками.
Приём платежей через счета
Счёт — это способ принять оплату от пользователя Telegram. Вы создаёте его через API, отправляете плательщику ссылку на него, и сумма зачисляется на баланс вашего приложения, как только плательщик подтвердит оплату.
Комиссии и лимиты Merchant API
Со счетов берётся комиссия платформы — из суммы, которую получаете вы; переводы и чеки ограничены по сумме. Цифры ниже — текущие настройки, а не условия договора: если они расходятся с тем, что показывает приложение, верно то, что в приложении, а самый надёжный источник — ваши собственные оплаченные счета.
Справочник Merchant API
Общие для всех методов правила плюс методы чтения каталога. Постраничные справочники методов: счета и возвраты, переводы и чеки, подписки, вебхуки.
Справочник API: счета и возвраты
Методы счетов: createInvoice, getInvoices, deleteInvoice, refundInvoice. Общие правила (аутентификация, конверт, суммы, spend_id) — на странице Справочник Merchant API; пошаговое введение — Приём платежей через счета.
Справочник API: переводы и чеки
Методы выплат. Перевод отправляет средства с баланса приложения прямо в кошелёк пользователя Telegram; чек — это ссылка на получение средств, сумма которой заранее блокируется на вашем балансе. Общие правила (аутентификация, конверт, суммы, spend_id) — на странице Справочник Merchant API.
Справочник API: подписки
Регулярные платежи — расширение над Crypto Bot. Вы создаёте план (сумма + период), отправляете пользователям ссылку на подтверждение, и платформа списывает оплату с баланса их кошелька каждый период, зачисляя её на баланс приложения за вычетом комиссии. Общие правила — на странице Справочник Merchant API.
Справочник API: вебхуки
Вебхуки доставляют события на ваш сервер в момент, когда они происходят. Задайте приложению Webhook URL в разделе Ещё → Merchant API — и платформа будет отправлять POST с подписанным JSON-телом на каждое событие, на которое вы подписаны.
Условия Merchant API
Эти условия регулируют Merchant API — приложения, API-токены, счета, подписки, переводы, чеки, вебхуки и подключение ИИ-агента. Они действуют в дополнение к общим условиям использования приложения и его политике AML. Создавая приложение, вы принимаете их; продолжая пользоваться приложением, созданным до 7 сентября 2026 года, вы принимаете их тоже.