Telegram 星星与 Premium 的 Fragment API —— 仅收 5% 手续费

定价：Fragment 价格 + 5%

每笔从 USD 余额支付的 API 订单，价格为 Fragment 实时价格加 5%，按美分向上取整。没有隐藏费用。

• POST /api/v1/usd/quote —— 提前获得准确价格，响应中包含 "markup_percent": 5
• 把它作为 max_usd 传入 —— 若价格上涨则不扣款，并返回 409 price_changed
• 价格在下单时锁定

示例：如果 Fragment 上 100 颗星为 $1.50，您支付 $1.575 → 取整后 $1.58。

为什么不自己对接 Fragment

• 无需 TON 钱包或购买 Toncoin —— 只需充值 USDT
• 无需抓取 Fragment 页面或刷新会话 —— 稳定的 HTTPS API
• 先核实收款人：/check-username 返回 180 秒有效的 verification_token
• Idempotency-Key 让重试更安全 —— 不会重复扣款
• 每笔完成的订单都在公开账本中有 TxId

4 步完成对接

1. 在控制台创建 API 密钥（X-API-Key 请求头）。
2. 用 TON 或 BEP20 网络的 USDT 充值 USD 余额（1 USDT 起）。
3. /check-username → /usd/quote → /stars/buy 或 /premium/buy（currency: "USD"，max_usd）。
4. 通过 GET /order/{id} 查询状态。

适合谁

Telegram 机器人和小程序开发者、网店，以及向自己客户销售星星和 Premium 的分销商。限流：每个密钥每秒 3 次请求。