机器人中的 Telegram Stars 账单(XTR):开发者支付流程分步说明
通过机器人用 Stars 出售数字商品:XTR 货币的 sendInvoice、10 秒内响应 pre_checkout_query、successful_payment、保存 charge_id、转发模式和上线清单。
发布于:

如果你的机器人出售订阅、内容、AI 请求或游戏道具等数字商品,就只能用 Telegram Stars 收款。下面依据官方 Bot API 文档,分步说明 Telegram Stars 账单(XTR) 流程。为什么必须是 Stars,见 机器人中的数字商品只能用 Stars。
流程总览
| 步骤 | 机器人 | Telegram |
|---|---|---|
| 1 | sendInvoice,currency = XTR | — |
| 2 | 等待 | pre_checkout_query |
| 3 | answerPreCheckoutQuery(10 秒内) | — |
| 4 | 等待 | successful_payment |
| 5 | 保存 charge_id 并发货 | — |
第 1 步:创建账单
机器人账单用 sendInvoice,provider_token 传空字符串,货币填 XTR,可发到私聊、群组或频道。内联账单通过 inputInvoiceMessageContent 由用户分享,Pay 按钮可多次使用。
第 2 步:转发行为
由 start_parameter 控制:多聊天账单的转发副本也有 Pay 按钮;单聊天账单只能在原聊天支付,转发副本显示机器人深链。发到与机器人私聊中的单聊天账单只能支付一次。
第 3 步:预结账
用户点 Pay 后,机器人收到 pre_checkout_query,必须在 10 秒内用 answerPreCheckoutQuery 回应;拒绝时写清易懂的原因。
第 4–5 步:结账与交付
收到 successful_payment 后才发货,并保存 telegram_payment_charge_id。
上线前检查
机器人所有者账号开启两步验证;提供 /terms、/support、/paysupport;用 refundStarPayment 处理争议(见 Stars 退款与 /paysupport);保证服务器稳定并备份支付数据。可在专用测试环境免费测试。若你的服务需要自动购买 Stars,可使用 PayStars API,并参阅 API 概览。
常见问题
能用加密货币或其他货币代替 Stars 吗?
不能,Telegram 应用内的数字商品和服务只能用 Stars 支付。
怎么测试支付?
把机器人连接到 Telegram 专用测试环境,可免费测试 Stars 支付。
怎么退款?
使用 Bot API 的 refundStarPayment 方法。
来源
用 USD(USDT)购买 Stars 和 Premium
API 密钥:0%(Fragment 原价)。网站:5%。
更多新闻
为 Telegram Stars 机器人撰写退款政策:模板与示例Telegram Stars 机器人的退款政策应包含哪些内容:适用条件、时限、/paysupport 与 refundStarPayment,以及可直接改写的示例文字。阅读 →
如果无法登录账户,你的 Telegram Stars 会怎样Stars 属于你的 Telegram 账户,而不是你的手机。了解失去访问权限时 Stars 会怎样、如何重新登录,以及如何保护你的余额。阅读 →
创作者或企业如何记录 Telegram Stars 收入如何清晰记录 Telegram Stars 收入:记什么、如何跟踪通过 Fragment 的提现、如何区分个人与业务,以及该向会计师提哪些问题。阅读 →