商户 API 是什么?
商户 API 是本应用给商家和机器人用的支付 API。您创建一个应用,拿到一个 API 令牌,就能用 它向 Telegram 用户收款、给他们打款、查自己的余额——全部在您自己的代码里完成。
它是用户看到的那个产品的开发者一侧:您通过 API 开出来的账单,正是他们点一下就 用余额付掉的那张账单。
用它能做什么
- 账单——开一份付款请求(固定的加密货币金额、按法币计价,或由付款人自己定额), 把链接发给付款人,付掉的那一刻您会收到一个带签名的回调。
- 退款——把一张已付账单的金额全额或部分退还给付款人——匿名付款的也能退。
- 转账——从您的应用余额把加密货币发给 Telegram 用户,一次一笔,或一批最多 100 笔。
- 红包——从您的应用余额开出谁都能领的链接。
- 订阅——周期性扣款:用户授权一次套餐,之后每期自动扣。
- 余额、币种、汇率和统计——供您自己记账用的只读接口。
各部分怎么串起来
- 您的应用有一个余额,跟您个人钱包是分开的。
- 用户付掉的账单给那个应用余额入账。
- 转账和红包从它里面花。
- 每一件要紧的事都能以带签名的 webhook 推到您的服务器。
付款在应用内部结清,不上链:没有网络手续费,不用等确认,钱一到就能用。付款人仍然可以 从外部钱包充值来支付账单——充值先落进他自己的钱包,账单从那里自动结清;在您这一侧,它跟 任何一张付掉的账单看起来完全一样。
兼容 Crypto Bot
这套 API 是刻意照着 Crypto Bot 做的:一样的方法名、一样的 {ok, result} 外层结构、一样的小数
字符串金额、一样的 webhook 签名方案。把一个现成的 Crypto Bot 集成指过来,只要改 base URL
和令牌——请求和响应的结构都不用动。
规范的令牌请求头是 TgPayCrypto-API-Token,同时也接受 Crypto-Pay-API-Token 作为别名,
好让现有的客户端库原样继续工作。
⚠️ 您的 API 令牌就是一把花钱的钥匙
拿到它的人可以把您应用的余额转走。请把它留在服务器一侧,别放进客户端应用和代码仓库, 一旦怀疑泄露就立刻更换。对那些不需要完整权限的服务器,请签发一个受限令牌,只给它实际 用得到的权限范围——见 API 参考。
接下来
这篇文章帮上忙了吗?
谢谢反馈。