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