商户 API 是什么？
商户 API 是本应用给商家和机器人用的支付 API。您创建一个应用，拿到一个 API 令牌，就能用 它向 Telegram 用户收款、给他们打款、查自己的余额——全部在您自己的代码里完成。
它为开发者提供用户端支付功能的接口：您通过 API 开出来的账单，正是他们点一下就 用余额付掉的那张账单。
用它能做什么
- 账单——开一份付款请求（固定的加密货币金额、按法币计价，或由付款人自己定额）， 把链接发给付款人，配置 webhook URL 后，可在付款后接收带签名的回调。
- 退款——把一张已付账单的金额全额或部分退还给付款人——匿名付款的也能退。
- 转账——从您的应用余额把加密货币发给 Telegram 用户，一次一笔，或一批最多 100 笔。
- 红包——从应用余额创建领取链接，可供任何人或指定收款人领取，具体受打款设置约束。
- 订阅——周期性扣款：用户授权一次套餐，之后每期自动扣。
- 余额、币种、汇率和统计——供您自己记账用的只读接口。
各部分如何配合
- 您的应用有一个余额，跟您个人钱包是分开的。
- 用户付掉的账单给那个应用余额入账。
- 转账和红包从应用余额扣款。
- 配置 URL 和事件订阅后，受支持的支付事件可通过带签名的 webhook 推送到您的服务器。
付款在应用内部结清，不上链：没有网络手续费，不用等确认，钱一到就能用。该选项可用时，付款人也可从外部钱包充值来支付账单。充值先进入其个人钱包；自动付款还要求余额充足、无转出限制且未超过付款期限。交付订单前，请确认账单状态为 paid。
兼容 Crypto Bot
这套 API 是刻意照着 Crypto Bot 做的：一样的方法名、一样的 {ok, result} 外层结构、一样的小数
字符串金额、一样的 webhook 签名方案。迁移现有集成时，请更换 base URL 和令牌，再对照参考文档测试您使用的方法。跟 Crypto Bot 一样，我们也有一个
测试网，配有单独的机器人和 base URL。
规范的令牌请求头是 TgPayCrypto-API-Token；2026-09-07 之前的旧名 TgCryptoPay-API-Token 仍然
可用，Crypto-Pay-API-Token 也作为别名接受，好让现有的客户端库原样继续工作。
⚠️ 您的 API 令牌就是一把花钱的钥匙
主令牌可在应用的打款模式和限额范围内授权转出资金。请把它留在服务器一侧，别放进客户端应用和代码仓库， 一旦怀疑泄露就立刻更换。对那些不需要完整权限的服务器，请签发一个受限令牌，只给它实际 用得到的权限范围——见 API 参考。
接下来
这篇文章对您有帮助吗？
谢谢反馈。