01 /
Telegram Stars 提现条件、冷却期与 TON 结算规则
Mini App 开发者、Bot 作者及创作者收到的 Telegram Stars 不能直接提现到银行卡,必须满 1,000 Stars 门槛并在经过 21 天安全锁定期后,在 Fragment 收益中心完成 KYC 提现为 TON 币再变现。这是官方唯一的合规结算路径,所有提现均由 Telegram 账本直连 Fragment 处理,不存在跳过等待期的人工通道。
资金使用建议按业务需求分优先级:若项目需要持续投流获客,优先在 Bot 后台把 Stars 直接转为 Telegram Ads 广告预算,可省去链上兑换损耗;若需要落袋为安,则应尽早开启账号两步验证(2FA),按“XTR 接口入账 → 等待 21 天滚动解锁 → 满 1,000 提现至 Tonkeeper → 转入交易所变现”的标准链路执行。
选对官方低损通道
优先用 @PremiumBot、Fragment TON 礼品或合规高区商店,避开黑卡代充。
核验虚拟卡 BIN 头
开卡前用 BIN 工具确认支持国际 3DS 与对应地区账单,避开高拒付预付卡段。
波场能量替代烧币
USDT-TRC20 转账前租用波场能量替代扣 13–27 TRX,实测直降约 80% 手续费。
严防 Approve 盗 U
正规能量租赁只需收款公开地址转账,凡要求扫码签钱包 Approve 授权均属诈骗。
02 /
分场景与分端实操:Bot API 接入 XTR 到绑定 Tonkeeper 提现
场景一:Bot 与小程序接入 Stars(XTR)收款链路。按 Telegram Bot API 规范,虚拟商品与订阅服务需使用 XTR 结算:后端调用 sendInvoice(对话发送账单)或 createInvoiceLink(生成链接供前端调用 Telegram.WebApp.openInvoice)时,须将 currency 设为 "XTR",provider_token 留空 "" 或省略,且 prices 数组仅允许 1 个条目,amount 直接传整数 Stars 数量。用户付款前,服务端必须在 10 秒内响应 pre_checkout_query 并调用 answerPreCheckoutQuery(ok=true);支付成功后,务必持久化保存 successful_payment 中的 telegram_payment_charge_id,用于调用 getStarTransactions 对账及 refundStarPayment 退款。
场景二:Desktop 桌面端与 iOS/Android 端核对余额并发起提现。打开目标 Bot 对话窗口,点击顶部名称进入资料页,依次点选 Edit(编辑)→ Balance(余额)(也可通过 @BotFather 发送 /mybots 进入;频道主则在频道资料页进入 Statistics → Monetization)。桌面端大屏可直观区分 Total Balance(总余额)与 Available Balance(可用余额),移动端以底部弹层展示。点击 Withdraw(提现)前必须满足两项安全条件:账号已开启两步验证云密码满 7 天,且当前设备已连续登录超过 24 小时。
场景三:Fragment 收益中心完成 Sumsub KYC 与提取 TON。通过 2FA 密码校验后,客户端会跳转至官方平台 fragment.com。登录 Bot 所属的 Telegram 账号后,按页面指引(达到风控或合规要求时触发)提交 Sumsub 身份验证,上传有效身份证件或护照并完成人脸活体检测。审核通过后连接非托管 TON 钱包(推荐 Tonkeeper),确认实时折算的 TON 数量与目标地址后签名广播,通常数分钟内到账。
03 /
真实踩坑、手续费拆解与防骗警告
为什么卡死 21 天安全锁定期?由于大量用户通过 Apple App Store 或 Google Play 内购购买 Stars,21 天滚动锁定期专门用于覆盖应用商店的退单窗口与黑卡拒付争议周期。只要在锁定期内发生恶意退款或发卡行拒付,对应 Stars 会直接从待解锁或可用余额中扣回,避免平台与开发者承担坏账。
看清 TG 星币提现手续费与常见操作误区。开发者提现时 Telegram 官方不额外抽成,结算基准约为每颗 Star 折合 0.013 美元等值的 TON(1,000 Stars 约合 13 美元),链上仅产生极低的 TON 网络 Gas 费。之所以与用户端充值金额有落差,是因为苹果和谷歌商店在用户购买 Stars 时已预先扣除约 30% 渠道费。此外,切勿混淆个人账号 Settings → My Stars 的消费余额与 Bot/频道收益,前者不可提现;在 Fragment 绑定收款地址时也不要直接填交易所充币地址,以免漏填 Memo 或触发合约入账失败,务必先提至自托管的 Tonkeeper 再转出。
高危防骗警告:严防“免等 21 天”地下回收商。锁定期内常有黑产中介或钓鱼 Bot 兜售“免等待、免 KYC、折扣秒收未解锁 Stars”。这类骗局通常只有两个套路:一是套取你的 Bot Token、管理员权限或 Telegram 登录验证码用于洗钱和盗号;二是伪造高仿 Fragment 页面诱导你输入 Tonkeeper 的 12/24 位助记词,一旦泄露,钱包余额与 Bot 所有权会瞬间被清空。

04 /
提现前检查清单与定制开发支持
发起首次 Fragment 提现前,建议按以下 4 项清单逐一核对:
1. 收款账本:确认 Bot/Mini App 全量使用 currency: "XTR",且已落库保存每笔订单的 telegram_payment_charge_id。
2. 余额与设备:确认单个 Bot 的 Available Balance 满 1,000 Stars,2FA 开启满 7 天且当前客户端登录超 24 小时。
3. 实名资料:确认 Sumsub 上传的证件清晰有效、主体信息一致,避免因照片反光或遮挡被驳回。
4. 钱包安全:确认收款地址为自己掌握助记词的 Tonkeeper 等非托管钱包,核对首尾字符后再签名。
如果团队在落地 sendInvoice / createInvoiceLink 接口、处理高并发 pre_checkout_query 防超时,或搭建多 Bot Stars 对账与 TON 自动结算后台时遇到瓶颈,需要为 Bot 或小程序接入 Stars 支付与自动结算?可查看 AnyTele 定制开发方案(/services)获取工程实现支持。
05 /
常见追问速答(FAQ)
Q1:1,000 Stars 提现门槛可以多个 Bot 凑单吗?
不可以。每个 Bot 和每个频道的 Stars 账本相互独立,必须单个实体下的可用余额达到 1,000 Stars,才能在 Fragment 发起提取。
Q2:Sumsub KYC 没通过会导致 Stars 被没收吗?
不会。验证失败或超时不会扣留余额,Stars 仍保存在 Bot 账户中,可按提示重新提交清晰证件,或直接将余额划转为 Telegram Ads 广告费消耗。
Q3:Fragment 提现点击确认后能撤回吗?
不能。TON 链上结算一经广播确认即不可逆转,一旦填错非本人掌控的地址将无法找回,点击确认前务必核验钱包地址。
参考资料
功能规则参照下列官方说明,实操步骤由 AnyTele 整理。
