Telegram 机器人如何接入加密货币收款（USDT 分步教程）
Telegram 机器人和付费社群的核心是即时交付。本文教你把加密货币支付网关接入机器人，让用户用 USDT 付款并自动获得访问权限。
要让 Telegram 机器人接入加密货币收款，做法是：用户点击“购买”时，由机器人后端通过加密货币支付网关的 API 创建一张账单，把返回的收银台链接作为内联按钮发给用户，并监听网关发来的签名 Webhook。付款确认后，机器人自动发放商品、激活码或频道邀请链接。
Telegram 机器人和付费社群天然适合加密货币收款：用户来自世界各地，很多人本来就持有 USDT，而且期望几秒内到货。本指南介绍整体架构、消息流程，以及保证系统稳定可靠的关键细节。
为什么加密货币特别适合 Telegram 机器人
- 全球用户：机器人的用户遍布各国，一个 USDT 定价就能覆盖所有人。
- 移动端优先：托管收银台直接在 Telegram 内置浏览器中打开，钱包 App 可扫描二维码或复制地址。
- 即时自动化：签名 Webhook 让机器人自动发货，无需有人盯着区块浏览器。
- 网络速度快：在 TRON 和 BNB Smart Chain 上，付款通常约一分钟即可确认。
与 SaaS、主机和数字商品一样，Telegram 机器人和付费社群也是 mistKET 重点服务的核心场景之一。
架构：三个组成部分
| 组件 | 作用 |
|---|---|
| Telegram 机器人（通过 Bot API） | 与用户交互：菜单、按钮、发货消息 |
| 你的后端 | 保存订单、调用网关 API、接收 Webhook、保管密钥 |
| mistKET 网关 | 托管收银台、链上监控、确认数统计、结算 |
无论你用什么框架，Telegram 机器人加密货币收款的模式都是一样的。机器人和后端通常是同一个小服务。关键在于 API 密钥和 Webhook 密钥只能保存在服务器上，绝不能出现在消息或客户端代码中。Telegram 官方的机器人文档见 core.telegram.org。
分步教程：Telegram 机器人接入加密货币收款
- 用户选择商品 — 例如通过内联键盘选择“1 个月会员”。后端创建一条订单，并记录 Telegram 用户 ID。
- 后端创建账单 — 发送一次签名的
POST /api/v1/invoices，包含金额、币种、你的订单号和回调地址。 - 机器人发送支付按钮 — 一个指向返回的
checkout_url的内联 URL 按钮，再附一句提示：“请在所选网络上发送准确金额。” - 用户付款 — 在托管页面上选择 TRON、BSC、Ethereum 或 Arbitrum 上的 USDT（或 TRX、BNB、ETH），从钱包或交易所转账。
- 收到 Webhook — 达到确认数后，你的回调地址会收到包含订单号的签名
invoice.confirmed事件。 - 机器人发货 — 验证签名、将订单标记为已付款，然后把激活码、文件或一次性频道邀请链接发到用户的聊天中。
最简数据模型
运营付费机器人不需要复杂的数据库，三张表就能覆盖大多数场景：
| 数据表 | 关键字段 | 用途 |
|---|---|---|
| users | telegram_id, username, access_until | 谁有访问权限、到期时间 |
| orders | order_id, telegram_id, product, amount, status | 每次购买尝试一行 |
| invoices | order_id, invoice_uuid, checkout_url, network, paid_amount | 关联你的订单与网关账单 |
Webhook 到达后，按 order_id 查找订单，确认尚未发货，更新状态，再通过 telegram_id 给用户发消息。这就是完整的发货闭环。
消息文案示例
聊天中的清晰措辞能显著减少客服咨询。一套效果不错的文案：
- 账单消息：“您的订单：1 个月会员，15 USD。点击“支付”打开安全付款页面，请在所选网络上发送准确金额。”
- 已付款：“已检测到付款，正在等待网络确认，通常需要一两分钟。”
- 已确认：“付款已确认。这是您的邀请链接，仅可使用一次。”
- 少付：“我们收到的金额少于账单金额。请打开同一付款页面补足差额。”
- 已过期：“此账单已过期，点击下方按钮获取新账单。”
无需截图的客服流程
用户咨询付款问题时，只需让对方提供订单号。在商户后台打开账单即可看到应付金额、实收金额、网络和交易哈希，完全不需要用户发截图或钱包地址。在机器人里加一个“客服”按钮自动带上订单号，大多数付款问题就能变成十秒钟的查询，而不是冗长的对话。
聊天内的良好交互模式
- 发送状态更新。收到
invoice.paid时回复“已收到付款，等待确认”；收到invoice.confirmed时发货。 - 以美元显示价格，由网关负责换算。汇率在账单有效期内锁定。
- 解释倒计时，说明一次即可，避免用户看到计时器就慌张。
- 提供“查询状态”按钮，通过 API 查询账单，方便用户稍后回来查看。
- 礼貌处理少付。收到
invoice.underpaid时告诉用户还差多少；多笔部分付款会累计到总额。 - 处理过期。收到
invoice.expired时，一键提供新账单。
订阅与付费社群
对于按月访问，在每个周期结束时创建新账单，并提前几天以续费消息发送。收到 invoice.confirmed 后，在数据库中延长用户的到期日。如果周期结束前没有付款，就移除访问权限。加密货币转账由付款方主动发起，因此续费永远是用户自己支付的一张账单，不存在信用卡那样的自动扣款。
可靠性检查清单
- 幂等性：Webhook 会按退避策略重试数小时，同一事件可能到达两次。发送任何内容前先检查订单是否已发货。
- 签名校验：在信任任何事件之前，先验证
X-Mistket-Signature（用 Webhook 密钥对时间戳和原始请求体做 HMAC-SHA256）。 - 不要把聊天消息当作凭证。用户说“我已付款”或发来截图，永远不能替代 Webhook。
- IP 白名单：在商户后台把 API 访问限制为你的机器人服务器。
- 日志：后台提供 Webhook 投递日志、应收与实收金额以及交易哈希，便于处理客服工单。
签名与验签的完整代码示例，请参阅加密货币支付 API 接入。
还没有开发者？先从支付链接开始
如果你手动运营一个小型付费群，可以在商户后台创建账单，通过私信发送链接。在后台确认付款后，再手动把成员拉进群。这种方式无法规模化，但能让你在开发机器人之前先验证定价。详见加密货币支付链接与账单。
立即开始
准备好为自己的 Telegram 机器人接入加密货币收款了吗？请通过 Telegram @mistnetwork 申请成为商户，附上机器人或社群链接以及预计交易量。审核通过后，当天即可获得 API 密钥。你可以在开发者专区查看请求和 Webhook 示例，并在商户登录页面管理密钥。
