Fragment API для Telegram Stars и Premium — комиссия 5%

Как считается цена: Fragment + 5%

Каждый API-заказ с долларового баланса стоит как текущая цена на Fragment плюс 5%, с округлением вверх до цента. Скрытых платежей нет.

• POST /api/v1/usd/quote — точная цена заранее, в ответе "markup_percent": 5
• Передайте её как max_usd: если цена вырастет, деньги не спишутся, придёт 409 price_changed
• Цена фиксируется в момент заказа, без доплат после

Пример: если 100 звёзд на Fragment стоят $1,50, вы платите $1,575 → $1,58 после округления.

Чем это лучше, чем работать с Fragment напрямую

• Не нужен TON-кошелёк и покупка Toncoin — пополняете баланс в USDT
• Никакого парсинга страниц Fragment и обновления сессий — стабильный HTTPS API
• Получатель проверяется заранее: /check-username выдаёт verification_token на 180 секунд
• Idempotency-Key защищает от двойного списания при ретраях
• Каждый выполненный заказ виден в публичном реестре с TxId

Подключение за 4 шага

1. Создайте API-ключ в личном кабинете (заголовок X-API-Key).
2. Пополните USD-баланс в USDT через TON или BEP20 (от 1 USDT).
3. /check-username → /usd/quote → /stars/buy или /premium/buy с currency: "USD" и max_usd.
4. Отслеживайте статус через GET /order/{id}.

Кому подходит

Владельцам Telegram-ботов и мини-приложений, интернет-магазинам и реселлерам, которые продают звёзды и Premium своим клиентам. Лимит — 3 запроса в секунду на ключ.