Самое дешёвое Fragment API для Telegram commerce

Fragment Stars API

Самое дешёвое production API для Telegram Stars и Premium: KYC 0%, без KYC 0,25%, backend-подпись кошелька и статусы очереди.

KYC 0% · NO-KYC 0.25% · Самое дешёвое Fragment API

Открыть docs→Песочница API

Продакшен API endpoint

https://api-fragment.duckdns.orgHTTPS · порт 443
0%
комиссия API в KYC навсегда
0.25%
комиссия API без KYC
No token
клиентский токен не нужен
live flow
POST /api/v1/stars/buy202
{
  "username": "@client",
  "amount": 50,
  "kyc_commission": "0%"
}
01
Backend отправляет запрос покупки
02
TON кошелек подписывает транзакцию
03
Работает очередь Stars или Premium flow
04
Финальный статус возвращается в магазин
safety rail

Никогда не выносите seed или Fragment cookies во frontend. Не делайте слепой retry после возможной подписи или отправки транзакции.

Пример интеграции

Готовый Telegram магазин

Используйте open-source пример Telegram-бота/магазина для продажи Stars и Premium через это API.

Открыть пример магазинаGitHub SDK
POSTStars queue
/api/v1/stars/buy
POSTPremium direct
/api/v1/premium/buy
GETRate check
/api/v1/commission/rates
Политика комиссий

Комиссионные ставки

KYC всегда бесплатный. Без KYC — всего 0,25%. Обе публичные ставки можно проверить перед каждой покупкой.

Проверить 0% / 0,25% через GET /api/v1/commission/rates

KYC режим - всегда бесплатно
0%
0% комиссия API навсегда - пользователь предоставляет Fragment cookies
Режим Non-KYC
0.25%
Всего 0,25% комиссии API — используются cookies владельца
Production-интеграция

API Telegram Stars для реальных магазинов

Fragment Stars API подключает backend, Telegram-бота, маркетплейс или панель реселлера к покупке Telegram Stars и Premium на Fragment.com. Работайте напрямую по REST или через поддерживаемый Python SDK: получите актуальную цену, создайте заказ и проверяйте очередь до финального результата. Выданный API-токен не нужен — подпись кошелька и данные Fragment остаются только в вашем серверном окружении.

01

KYC режим с комиссией API 0%

KYC режим подходит операторам с действующими Fragment cookies. Backend передаёт seed своего кошелька и Fragment-сессию, а API выполняет поиск получателя, расчёт цены, подготовку транзакции, обработку очереди и возврат финального статуса. Комиссия API всегда равна 0%: оплачиваются только цена Fragment и расходы сети.

02

Режим без KYC для быстрого старта

Режим без KYC использует Fragment-сессию сервиса, а комиссия API составляет всего 0,25%. TON остаётся способом оплаты по умолчанию для совместимости; при поддержке доступен USDT в сети TON. Перед созданием заказа запрашивайте публичные ставки, а не фиксируйте их в коде магазина.

03

Безопасная очередь и понятные ошибки

Покупка Stars возвращает идентификатор запроса для проверки статуса. Считайте completed и failed финальными состояниями, храните собственный idempotency key и не отправляйте слепые повторы после возможной подписи транзакции. Ошибки отдельно объясняют неверный username, недостаточный баланс, временную недоступность Fragment и сбой отправки транзакции.

Четыре шага

От оплаты до доставки

  1. 1.Получите текущую цену Stars или Premium и публичные ставки комиссии.
  2. 2.Отправьте серверный запрос покупки с @username и количеством.
  3. 3.Сохраните request_id и проверяйте очередь без дублирующих повторов.
  4. 4.Завершите заказ только после финального успешного статуса API.
Готово для AI агентов

Безопасные инструкции для клиентов на vibe coding.

Передайте Codex, Claude, Cursor или другому coding agent готовый контекст до генерации кода. Это защищает от придуманных API токенов, seed во frontend и повторных покупок из-за retry.

llms.txt
Короткий контекст для агента

Минимальный entrypoint с endpoint, ссылками и жесткими правилами.

llms-full.txt
Полный контекст интеграции

REST примеры, SDK, поведение очереди и обработка ошибок.

Codex
CODEX_SKILL.md

Добавьте в проект Codex или подключите через AGENTS.md.

Claude
CLAUDE_SKILL.md

Скопируйте в CLAUDE.md или попросите Claude прочитать перед кодингом.