中文 ▾
O‘zbek
Русский
English
한국어★ 面向开发者
Telegram Stars API（星星接口）
在您自己的机器人、商店或应用中销售 Telegram 星星和 Premium。一个 HTTPS API，与 StarKerak 机器人和网站共享同一余额。
自动到账多数订单几分钟内完成
用户名校验付款前先核实
公开透明的价格网站、机器人、API 一致
公开账本每笔订单都有 TxId
API 能做什么
- POST /api/v1/check-username —— 核实收款人并获取短期 verification token
- POST /api/v1/stars/buy 和 /api/v1/premium/buy —— 创建订单（必须携带 Idempotency-Key）
- GET /api/v1/order/{id} 和 /api/v1/orders —— 订单状态与历史
- USD 钱包、USDT 充值单和 /api/v1/usd/quote 报价
认证使用 X-API-Key 请求头。密钥在控制台创建，除非您主动吊销，否则不会过期。
为生产环境设计
每笔订单都带有您的 Idempotency-Key，重试不会重复扣款。收款人校验可避免向不存在的用户名付款。限流为每个密钥每秒 3 次请求。
USD 订单请传 currency=USD 和 max_usd，设定您可接受的价格上限。
透明可查
每笔完成的订单都会在 PayStars 公开账本记录 TxId，您和您的客户都可以独立核验到账。
Fragment 价格 + 5%
USD 余额订单按 Fragment 实时价格加 5% 计价。用 POST /usd/quote 获取价格，并用 max_usd 设上限。详见 Fragment API 页面。
常见问题
有沙盒环境吗？
对接时请用小额真实订单（50 颗星）；Idempotency-Key 保证重试安全。
支持哪些编程语言？
任何支持 HTTPS 的语言。可参考 Python、Node.js 和 PHP 快速上手。
API 密钥会过期吗？
不会。在控制台吊销前一直有效。
可以用美元支付吗？
可以 —— 用 USDT（TON 或 BEP20）充值 USD 余额，并传 currency=USD。
相关页面
Telegram 星星与 Premium 的 Fragment API —— 仅收 5% 手续费Fragment 没有用于转售星星和 Premium 的公开 API。PayStars 提供按 Fragment 价格加 5% 计费的生产级 REST API —— 无需 TON 钱包、不承担 Toncoin 汇率风险、不用维护会话。.Telegram Stars API：Python 快速上手使用 requests 库实现的最小化、可用于生产的流程。.Telegram Stars API：Node.js 快速上手Node 18+ 内置 fetch，无需额外依赖。.Telegram Stars API：PHP 快速上手一个可放入任何 PHP 项目或机器人的精简 cURL 助手。.API 美元定价用美元经营星星业务：USDT 充值的 USD 余额、实时报价、每笔订单的价格上限。.不用 Fragment 购买 Telegram 星星Fragment 需要 TON 钱包和 Toncoin。如果您只想要星星，有更简单的方法。.
准备下单了吗？
使用 Telegram 登录 —— StarKerak 余额可在网站、WebApp 和 API 中通用。