指南 · Telegram Stars

机器人中的 Telegram Stars 账单(XTR):开发者支付流程分步说明

通过机器人用 Stars 出售数字商品:XTR 货币的 sendInvoice、10 秒内响应 pre_checkout_query、successful_payment、保存 charge_id、转发模式和上线清单。

发布于:

机器人中的 Telegram Stars 账单(XTR):开发者支付流程分步说明

如果你的机器人出售订阅、内容、AI 请求或游戏道具等数字商品,就只能用 Telegram Stars 收款。下面依据官方 Bot API 文档,分步说明 Telegram Stars 账单(XTR) 流程。为什么必须是 Stars,见 机器人中的数字商品只能用 Stars。

流程总览

步骤机器人Telegram
1sendInvoice,currency = XTR—
2等待pre_checkout_query
3answerPreCheckoutQuery(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%。

开始