TgPay Merchant API

com.tgpaybot由 tgpaybot.com 發布v1.0.2更新於 Oct 24, 2026

Accept crypto payments via the TgPay Merchant API — invoices, subscriptions, webhooks.

已驗證Streamable HTTP可網頁執行金融開發者工具商業與電商

概覽

AI 產生的概覽

TgPay Merchant API MCP 伺服器，讓助理建立加密貨幣發票與訂閱方案、查看餘額與統計，並管理 webhook。

可以做什麼
閱讀整合文件，核驗商戶權杖及其權限範圍、應用程式資訊與 webhook 設定，以及支援的資產與匯率。查看各資產餘額、交易量與筆數統計，並列出發票、支票、轉帳、訂閱方案與訂閱者。建立一次性付款發票，刪除未付款發票。建立不可變更的定期計費方案、封存方案並取消個別訂閱。更新應用程式名稱、webhook 位址與 webhook 事件訂閱清單。透過 Telegram 核准連結發起權杖簽發，並輪詢取得具權限範圍的權杖。
適用情境
適用於商戶希望由助理處理 TgPay 加密貨幣付款事務的情境：開立發票、設定或管理訂閱、查看餘額與統計，或設定 webhook。整合前應先從文件工具著手。
執行需求
以遠端 streamable HTTP 端點形式執行於 app.tgpaycrypto.com，無需本機套件。需要一個 TgPay 商戶應用程式。驗證為選用：提供 TgPayCrypto-API-Token 標頭，或省略它並使用 connect 工具，該工具會回傳 Telegram 核准連結與供 connect_status 使用的 poll_secret。需要能存取該端點與 Telegram 的網路。
安裝前請注意
connect 流程只回傳一次 API 權杖，應立即儲存到專案的 .env，切勿列印到日誌中。connect 簽發的權杖權限限於讀取、發票、訂閱與 webhook，無法將資金轉出應用程式。相關工具會建立發票與方案、刪除未付款發票與未領取的支票、取消訂閱並變更 webhook 設定，這些寫入操作會影響真實付款流程。訂閱方案建立後不可變更。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 TgPay Merchant API，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.tgpaybot%2Fmerchant-api/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "tgpay-merchant-api": {
      "type": "http",
      "url": "https://app.tgpaycrypto.com/mcp"
    }
  }
}

工具

20

get_docs

Read a TgPay Merchant API integration doc. START HERE before integrating: topics quickstart, invoices, subscriptions, transfers-checks, webhooks, errors.

輸入參數topic必填

connect

Start 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.

輸入參數app_name必填

connect_status

Poll 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.

輸入參數poll_secret必填

getMe

Verify the token: app id, name, webhook config, token scopes.

無需輸入參數。

getBalance

Merchant app balance per asset (available + onhold).

無需輸入參數。

getCurrencies

Supported crypto assets (code/name/decimals) and fiats.

無需輸入參數。

getExchangeRates

Current asset↔fiat display rates.

無需輸入參數。

getStats

App volume/count stats for a period.

輸入參數end_atstart_at

getInvoices

List invoices (newest first).

輸入參數fiatassetcountoffsetstatusinvoice_ids

getChecks

List checks.

輸入參數assetcountoffsetstatuscheck_ids

getTransfers

List app→user transfers.

輸入參數assetcountoffsetspend_idtransfer_ids

getSubscriptionPlans

List subscription plans.

無需輸入參數。

getSubscriptions

List subscriptions (subscribers).

輸入參數statusplan_iduser_id

createInvoice

Create a one-off payment invoice; the payer opens result.mini_app_invoice_url. See the invoices doc.

輸入參數fiatassetamountpayloadswap_toexpires_indescriptionpaid_btn_urlcurrency_typepaid_btn_nameallow_commentshidden_message另有 3 個

deleteInvoice

Delete an unpaid invoice.

輸入參數invoice_id必填

deleteCheck

Delete an unclaimed check (refunds the hold).

輸入參數check_id必填

createSubscriptionPlan

Create an IMMUTABLE recurring-billing plan; send payers to result.mini_app_subscribe_url. See the subscriptions doc.

輸入參數name必填asset必填amount必填period_days必填

archiveSubscriptionPlan

Stop new signups for a plan (live subscriptions keep renewing).

輸入參數plan_id必填

cancelSubscription

Stop future charges for one subscription (paid time runs out).

輸入參數subscription_id必填

updateApp

Update 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.

輸入參數namewebhook_urlwebhook_events

版本歷史

1
  1. v1.0.2最新Sep 16, 2026

評分

已滿足適用檢查項的 72%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分

    請在註冊中心條目中發布圖示。

  • 文件15 分

    請宣告包含 README 的 GitHub 儲存庫，或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款不適用

    託管服務按其提供方的條款使用，因此這裡不要求授權條款。此檢查項不計入百分比。