Production API for Telegram commerce

Fragment Stars API

A production endpoint for Telegram Stars and Premium purchases with backend-only wallet signing, queue status, and permanent 0% API commission in KYC mode.

Production API Endpoint

https://fragment-api.ydns.eu:8443base URL
0%
KYC API commission forever
No token
No issued client token required
Backend
Secrets stay server-side
live flow
POST /api/v1/stars/buy202
{
  "username": "@client",
  "amount": 50,
  "kyc_commission": "0%"
}
01
Backend sends purchase request
02
TON wallet signs transaction
03
Stars queue or Premium flow runs
04
Final status returns to your shop
safety rail

Never expose seed or Fragment cookies in frontend code. Do not retry blindly after a transaction may have been signed or sent.

Example integration

Ready-made Telegram shop

Use the open-source Telegram bot/shop example to sell Stars and Premium through this API.

POSTStars queue
/api/v1/stars/buy
POSTPremium direct
/api/v1/premium/buy
GETRate check
/api/v1/commission/rates
Pricing policy

Commission Rates

KYC mode is permanently free. If you want to double-check before using the API, call the public commission rates endpoint.

Check current rates via GET /api/v1/commission/rates

KYC Mode - Always Free
0%
0% API commission forever - user provides Fragment cookies
Non-KYC Mode
1.0%
Higher commission - uses owner cookies