TgPay Merchant API

TgPay Merchant API: приём криптоплатежей, инвойсы и подписки через MCP

От сообществаРаботаетНужен API-ключГлобальныйБесплатноТолько чтение

Что умеет

  • Создавать и удалять счета на оплату
  • Управлять планами подписки и отменять подписки
  • Смотреть баланс, курсы валют и статистику по платежам
  • Просматривать историю инвойсов, чеков и переводов
  • Настраивать приложение и резервного провайдера

Какие данные видит

Ассистент работает с платёжным аккаунтом продавца по API-ключу — балансом, счетами и подписками.

Нужен ли аккаунт

Нужен API-ключ из настроек сервиса

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

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

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

Адрес сервера, который нужно вставить в настройках Claude:

https://app.tgpaycrypto.com/mcp

  1. Откройте Claude (сайт claude.ai или приложение для компьютера).
  2. Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
  3. Нажмите Добавить пользовательский коннектор (Add custom connector).
  4. Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
  5. В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

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

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://app.tgpaycrypto.com/mcp

  1. Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
  2. Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
  3. Откройте Настройки → Коннекторы и нажмите Создать (Create).
  4. Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
  5. В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
  6. В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

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

Адрес сервера, который нужно вставить в настройках Cursor:

https://app.tgpaycrypto.com/mcp

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

  1. В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
  2. Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
  3. Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (20)

Технические названия из tools/list. Нужны только разработчикам.

get_docsRead a TgPay Merchant API integration doc. START HERE before integrating: topics quickstart, invoices, subscriptions, transfers-checks, webhooks, errors.
connectStart token issuance WITHOUT the Mini App UI: creates a merchant-app request and returns a t.me approve link plus a poll_secret. Show the link to the human — they approve with one button in the @tgpaycryptobot bot — then call connect_status with the poll_secret. Use only when no API token is configured yet.
connect_statusPoll a connect request. Returns pending | denied | expired, or — once approved — the app id and the API TOKEN (returned exactly once: save it to the project's .env immediately, never print it in logs). The token is SCOPED (read, invoices, subscriptions, webhooks) — it cannot move money out of the app; transfers/refunds/checks need the primary token the human holds in the Mini App. Poll every 3-5 seconds while pending.
getMeVerify the token: app id, name, webhook config, token scopes.
getBalanceMerchant app balance per asset (available + onhold).
getCurrenciesSupported crypto assets (code/name/decimals) and fiats.
getExchangeRatesCurrent asset↔fiat display rates.
getStatsApp volume/count stats for a period.
getInvoicesList invoices (newest first).
getChecksList checks.
getTransfersList app→user transfers.
getSubscriptionPlansList subscription plans.
getSubscriptionsList subscriptions (subscribers).
createInvoiceCreate a one-off payment invoice; the payer opens result.mini_app_invoice_url. See the invoices doc.
deleteInvoiceDelete an unpaid invoice.
deleteCheckDelete an unclaimed check (refunds the hold).
createSubscriptionPlanCreate an IMMUTABLE recurring-billing plan; send payers to result.mini_app_subscribe_url. See the subscriptions doc.
archiveSubscriptionPlanStop new signups for a plan (live subscriptions keep renewing).
cancelSubscriptionStop future charges for one subscription (paid time runs out).
updateAppUpdate app name / webhook_url (https) / webhook_events opt-in list. Needs the 'webhooks' scope (the connect-issued token has it) or the primary token. See the webhooks doc for the event types and signature verification.