商户 API（开发者）
商户 API：应用、账单、转账和 webhook。
商户 API 是什么？
商户 API 是本应用给商家和机器人用的支付 API。您创建一个应用，拿到一个 API 令牌，就能用 它向 Telegram 用户收款、给他们打款、查自己的余额——全部在您自己的代码里完成。
开发者上手
在 Mini App 里创建一个应用，把它的 API 令牌复制下来（只有这一次机会），然后就能开始调 API 了。整套设置都在更多 → 商户 API里。
接入 AI 智能体
将支持远程 MCP 服务器的 AI 编程智能体连接到 https://app.tgpaycrypto.com/mcp。它可以读取 API 文档、申请创建商户应用、配置 webhook，并协助编写集成代码。您在机器人中批准应用创建后，智能体会收到受限令牌，无需手动复制。接收真实付款前，请审核并测试完成的集成。
用账单收款
账单是您向 Telegram 用户收钱的方式。您通过 API 开一张，把链接发给付款人，付款成功后，扣除商户手续费的款项计入您的应用余额。
商户 API 的费用和限额
账单会收取平台手续费，从商户收到的款项中扣除；转账和红包则受金额上下限的约束。下面这些数字是 当前的设置，不是合同条款——跟您在应用里看到的对不上时，以应用为准，而最靠得住的依据永远是 您自己那些已付账单。
商户 API 参考
本页介绍各方法共用的调用规则，以及只读的目录类方法。各类方法的详细说明见： 账单和退款、转账和红包、 订阅、webhook。
API 参考：账单和退款
账单相关的方法：createInvoice、getInvoices、deleteInvoice、refundInvoice。通用约定 （鉴权、外层结构、金额、spend_id）见商户 API 参考页面； 具体操作步骤见用账单收款。
API 参考：转账和红包
本页介绍打款方法。转账将应用余额中的资金发送到 Telegram 用户的钱包，或暂时托管，等待新收款人打开机器人；红包是一条领取链接，创建时会预先锁定金额。通用约定（鉴权、响应结构、金额、spend_id）见 商户 API 参考页面。
API 参考：订阅
周期性扣款——相对 Crypto Bot 的扩展。您建一个套餐（金额 + 周期），把它的授权链接发给 用户，之后平台每一期从他们的钱包余额里扣款，扣掉手续费之后给您的应用余额入账。通用约定见 商户 API 参考页面。
API 参考：webhook
Webhook 用于在事件发生后将消息推送至您的服务器。在更多 → 商户 API里给您的应用设好 Webhook URL（选填）；此后您订阅的每一个事件，平台都会 POST 一段带签名的 JSON。
商户 API 使用条款
本条款适用于商户 API——包括应用、API 令牌、账单、订阅、转账、红包、webhook 以及 AI 智能体 接入。本条款是本应用通用使用条款及其 AML 政策的补充。创建应用即表示您接受本条款；继续 使用 2026年9月7日之前创建的应用，同样视为接受本条款。