★ Dành cho nhà phát triển

Telegram Stars API

Bán Telegram Stars và Premium trong bot, cửa hàng hoặc ứng dụng của bạn. Một API HTTPS, một số dư dùng chung với bot StarKerak và trang web.

Giao tự độnghầu hết đơn trong vài phút
Kiểm tra tên người dùngtrước khi bạn thanh toán
Giá công khaigiống nhau trên trang web và API
Sổ cái công khaimỗi đơn hàng có một TxId

API làm được gì

  • POST /api/v1/check-username — xác minh người nhận và nhận mã xác minh ngắn hạn
  • POST /api/v1/stars/buy và /api/v1/premium/buy — tạo đơn (bắt buộc Idempotency-Key)
  • GET /api/v1/order/{id} và /api/v1/orders — trạng thái và lịch sử
  • GET /api/v1/prices, /api/v1/account, ví USD và hóa đơn USDT

Xác thực dùng header X-API-Key. Khóa được tạo trong bảng điều khiển và không hết hạn cho đến khi bạn thu hồi.

Được xây cho vận hành thực tế

Mỗi đơn mang Idempotency-Key của bạn, nên thử lại không bao giờ bị trừ tiền hai lần. Bước kiểm tra người nhận ngăn thanh toán tới tên người dùng không tồn tại. Giới hạn tốc độ là 10 yêu cầu mỗi giây cho mỗi khóa.

Mọi đơn được thanh toán từ số dư USD (currency=USD; UZS được coi là USD). Truyền max_usd để giới hạn mức giá bạn chấp nhận.

Minh bạch

Mỗi đơn hoàn tất nhận một TxId được ghi trên sổ cái công khai của PayStars, để bạn và khách hàng có thể tự xác minh việc giao hàng.

Giá Fragment, 0% (trang web: 5%)

Đơn qua API key từ số dư USD được tính theo giá Fragment trực tiếp 0% (trang web: 5%); đơn trên trang web và ứng dụng mini — số tiền chính xác được hiển thị trước khi thanh toán. Lấy giá bằng POST /usd/quote và giới hạn bằng max_usd. Chi tiết trên trang Fragment API.

Câu hỏi thường gặp

Có môi trường thử nghiệm không?

Dùng đơn thật nhỏ (50 Stars) khi tích hợp; khóa chống trùng giúp thử lại an toàn.

Hỗ trợ những ngôn ngữ nào?

Mọi ngôn ngữ có HTTPS. Xem hướng dẫn nhanh Python, Node.js và PHP.

Khóa API có hết hạn không?

Không. Khóa vẫn hợp lệ cho đến khi bạn thu hồi trong bảng điều khiển.

Tôi có thể thanh toán bằng USD không?

Có — nạp số dư USD bằng USDT (TON, BEP20 hoặc TRC20) và gửi currency=USD.

Sẵn sàng đặt hàng?

Đăng nhập bằng Telegram — số dư StarKerak của bạn dùng được trên trang web, trong WebApp và qua API.