Fragment API: звёзды, Premium, GRAM и Steam 1:1

Fragment API от KRAB.GG — это партнёрский интерфейс, через который ваш бот, сайт или CRM выдаёт Telegram Stars, Premium и GRAM на аккаунт по @username и пополняет баланс Steam по логину, одним HTTP-запросом. Оплату вы принимаете у себя, наценку ставите сами. Комиссия на Fragment-товары — 1%, пополнение Steam идёт без комиссии: отправили $10 — пришло $10. Документация лежит на странице для разработчиков, интеграционный бот — @apistarsbot.

Коротко о партнёрском API

• Ассортимент — Telegram Stars, Telegram Premium на 3/6/12 месяцев, GRAM и пополнение Steam. Всё в одном ключе и одном балансе.
• Доставка Telegram-товаров c Fragment.com — на аккаунт по @username.
• Экономика — 1% на товары Fragment, 0% на Steam. Steam-сумма задаётся в долларах: от $0.5 до $1000, и ровно столько приходит на баланс клиента.
• Стек надёжности — идемпотентность по вашему идентификатору заказа, проверка получателя до оплаты, запрос цены перед покупкой, вебхуки о смене статуса, тестовый режим.
• Кому нужно — владельцам Telegram-ботов, продавцам на FunPay и Playerok, донат-сервисам, агентствам с Telegram Ads, SaaS-платформам и всем, кто устал выдавать заказы вручную.

Что такое Fragment API и зачем он магазину

Fragment API — программный способ купить цифровой товар Telegram без ручного захода в интерфейс: вы отправляете запрос с указанием товара, количества и @username получателя, а система проводит выдачу и возвращает статус заказа. По сути, это замена человека, который ночью сидит и вбивает ники в форму.

Разница видна на цифрах воронки. Ручная выдача — это минуты ожидания, ночные простои, опечатки в никах и возвраты. Автовыдача — секунды, круглосуточно и без участия оператора.

Ключевой момент: продавать вы продолжаете сами. Ваш бот, ваша витрина, ваши цены, ваши покупатели, ваши платёжные методы. API отвечает только за то, чтобы товар физически оказался на аккаунте клиента.

Именно поэтому «партнёрское» — не маркетинговое слово. Мы не забираем вашу аудиторию и не показываем ей нашу цену: конечный пользователь видит только ваш магазин.

Ассортимент: Stars, Premium, GRAM и Steam

Telegram Stars — по @username, от 50 до 1 000 000 за заказ

Stars — внутренняя валюта Telegram, за которую покупают доступ в ботах, подарки, реакции и подписки. Спрос стабильно высокий: запрос «купить звёзды телеграм» собирает более 26 тысяч показов в месяц, и это без учёта хвостов вроде «дёшево», «быстро» и «в России».

Через API вы указываете ник получателя и количество звёзд. Лимит на один заказ — от 50 до 1 000 000 звёзд, чего хватает и на розничный донат, и на закупку под рекламный бюджет.

Курс Stars плавающий и привязан к валютному рынку — это важно закладывать в наценку. Ориентир розничной цены и актуальное значение всегда видно на странице, где можно купить Telegram Stars; для API-партнёра цена запрашивается отдельным методом перед созданием заказа.

Полезный контекст: при покупке через Apple и Google звёзды дороже из-за комиссии магазинов приложений — по данным обзора способов покупки Stars на vc.ru, сторы забирают порядка 30%. Отсюда и берётся ваша розничная маржа: канал закупки дешевле стора, а покупателю удобнее платить рублями.

Telegram Premium — только 3, 6 и 12 месяцев

Premium выдаётся по тому же принципу: ник получателя плюс срок. Доступны подписки на 3, 6 и 12 месяцев — тарифа на один месяц у нас нет, и в витрине магазина его лучше не рисовать, чтобы не собирать возвраты.

Спрос здесь ещё жирнее звёздного: «купить телеграм премиум» — почти 14 тысяч показов в месяц, а «тг премиум» в разных написаниях — сотни тысяч. При этом по одной из публикаций 2026 года, оплата Premium привычными для России способами постепенно вытесняется внутренними инструментами Telegram — официального подтверждения от Telegram по конкретной дате нет, поэтому подавайте это осторожно, но факт спроса на посредников очевиден.

Розничные ориентиры по срокам смотрите на странице, где оформляется Telegram Premium — цена плавающая, точное число в статье хардкодить бессмысленно. Если продаёте Premium как подарок, пригодится наш разбор, как подарить Telegram Premium другу: сценарии в боте у покупателей ровно те же.

GRAM — на баланс аккаунта, без кошелька

GRAM через наше API зачисляется на баланс Telegram-аккаунта по @username, а не на криптокошелёк.

Почему это важно именно сейчас: 15 июня 2026 года нативный токен The Open Network официально переименован — Toncoin стал Gram, за смену проголосовали 81,2% участников, обмена токенов и миграции для владельцев не потребовалось. Запрос «купить gram» после ребрендинга вырос примерно в семь раз за два месяца — с трёхсот показов до почти двух тысяч.

Пополнение Steam — 1:1, по логину, без пароля

Сумма заказа указывается в долларах: от $0.5 до $1000, и ровно эта сумма попадает на баланс Steam. Сервисной комиссии через партнёрское API нет — отправили $10, пришло $10.

Зачисление идёт по логину аккаунта Steam. Пароль не нужен и не должен запрашиваться ни вами, ни нами. Это не гифт-карта и не код — деньги ложатся прямо на кошелёк Steam.

Здесь у офферa «без комиссии» есть нюанс, о котором честно стоит сказать вслух: на розничном рынке фраза «0%» часто означает, что наценка зашита во внутренний курс. Обзор сервисов пополнения Steam на vc.ru прямо разбирает эту механику и приводит рыночные комиссии в диапазоне единиц процентов. Наше «1:1» относится к сумме на балансе: доллар в заказе равен доллару в Steam, а свою розничную наценку вы ставите сами и видите её целиком.

Экономика: 1% на Fragment, 0% на Steam

Считаем на пальцах, потому что реселлеру важны не проценты в вакууме, а деньги в конце месяца.

• Telegram Stars, Premium, GRAM — комиссия партнёрского API 1% от суммы заказа; всё, что вы накрутили сверху в своей витрине, остаётся вам.
• Steam — 0%: заказ на $10 стоит вам ровно $10 в пересчёте по курсу заказа, и покупатель получает $10 на баланс.
• Ваша маржа — разница между розничной ценой в вашем боте и стоимостью заказа в API, минус комиссия вашего платёжного метода.
• Пример со звёздами — при заказе на 10 000 ₽ комиссия API составит 100 ₽.
• Пример со Steam — при обороте в 1000 заказов по $10 вы не отдаёте посреднику ни цента сверх суммы пополнения, и вся розничная наценка ваша.

Сравните с типовой картиной у посредников: по обзорам рынка, сервисы пополнения Steam закладывают несколько процентов сверху, а «нулевые» шлюзы прячут разницу в курсе. На объёме в сотни заказов это и есть та сумма, ради которой магазины меняют поставщика.

Отдельная строка дохода — партнёрская программа: если вы приводите других продавцов, а не только продаёте сами, работает партнёрская программа с выплатами до 30% с каждого заказа пожизненно.

Как подключить API за вечер: пошагово

1. Откройте бота интеграции — @apistarsbot. Это кабинет партнёра: ключи, баланс, история заказов, статусы.
2. Получите ключ доступа. Храните его на сервере, в переменных окружения. Ключ в клиентском коде бота или в репозитории — прямой путь к чужим заказам за ваш счёт.
3. Прогоните тестовый сценарий. Сначала запрос цены, потом проверка получателя, потом заказ на минимальную сумму — так вы поймаете ошибки формата до боевого трафика.
4. Пополните партнёрский баланс. Заказы списываются с него, поэтому держите запас под пиковые дни — в распродажу баланс улетает быстрее обычного.
5. Сделайте первый боевой заказ на себя. 50 звёзд на собственный @username — самая дешёвая проверка всей цепочки от кнопки в боте до уведомления.
6. Подключите вебхуки. Пусть смена статуса заказа сама меняет статус в вашей базе и отправляет клиенту сообщение — без опроса каждые пять секунд.
7. Включите продажу в витрине. Начните с одной категории, соберите первые сто заказов, потом добавляйте остальные.

Полные схемы запросов, поля и коды ответов — в документации API. Порядок вызовов в бою почти всегда один: цена → проверка получателя → создание заказа → статус.

```
POST /api/v1/orders
{
"product": "stars",
"username": "durov",
"quantity": 100,
"external_id": "shop-order-10245"
}
```

Поле с вашим собственным идентификатором заказа — не формальность, а страховка. Ниже объясняю почему.

Технические гарантии, которые проверяют перед интеграцией

Разработчик, который подключает поставщика, смотрит не на лендинг, а на четыре вещи: что будет при обрыве сети, как узнать статус, можно ли отладиться бесплатно и что случится при ошибке в данных.

• Идемпотентность по вашему external_id — повторный запрос с тем же идентификатором не создаёт второй заказ. Ретрай после таймаута безопасен, двойного списания не будет.
• Проверка получателя до оплаты — API отвечает, существует ли @username и доступен ли он для выдачи. Деньги не уходят на несуществующий ник.
• Запрос цены перед заказом — фиксируете себестоимость и считаете маржу до того, как показали клиенту сумму. При плавающем курсе это спасает от продаж в минус.
• Статусы и вебхуки — заказ можно опросить по идентификатору или получать пуш при смене состояния. Подпись входящих вебхуков проверяйте всегда, иначе кто угодно сможет «подтвердить» вам чужой заказ.
• Тестовый режим — отладка сценариев без реальных списаний, чтобы не платить за каждую опечатку в JSON.
• Возврат при неудачной выдаче — если заказ не исполнен, средства возвращаются на партнёрский баланс.

Практический совет из поддержки: самая частая ошибка интеграции — не таймаут и не подпись, а доверие к пользовательскому вводу. Люди присылают ник с пробелом, с эмодзи, со ссылкой t.me/, с «собакой» и без, копируют отображаемое имя вместо @username. Нормализуйте строку и вызывайте проверку получателя — это снимает большую часть возвратов.

Автовыдача на FunPay, Playerok и в своём боте

Сценарий продавца на маркетплейсе выглядит так: покупатель оплачивает лот, бот запрашивает у него @username, отправляет заказ в API и подтверждает выдачу в чате. Всё это укладывается в считанные секунды и работает ночью.

Спрос на связку подтверждается поиском: хвост «звёзды телеграм купить фанпей» собирает под три сотни показов в месяц — люди целенаправленно ищут продавцов Stars на площадках. Готовые расширения для маркетплейсов рекламируют ровно эту механику: приём заказа, вопрос про ник, автовыдача и авто-возврат при ошибке.

Что учесть при работе на площадках:

• Публичные API маркетплейсов часто неполные и недокументированные — сообщество продавцов регулярно жалуется на это применительно к FunPay. Закладывайте время на обвязку и ретраи со стороны площадки, но не со стороны выдачи.
• Скорость ответа в чате — часть репутации. Автовыдача бьёт по времени отклика лучше любого «онлайн 24/7» в профиле.
• Возвраты решает проверка получателя. Ошибочный ник — самая частая причина спора; отсекайте его до списания.

Для собственного бота схема ещё проще: aiogram или telegraf на вашей стороне, платёжный провайдер на входе, наш запрос на выходе. Отдельная витрина в вебе или плагин на сайте работают по той же логике — API не важно, откуда пришёл заказ.

Если вы только собираете ассортимент магазина, посмотрите, что вообще покупают конечники: разбор о том, зачем нужны звёзды Telegram в 2026 году, хорошо показывает, какие позиции стоит выносить на витрину первыми.

Кому это выгодно и когда подключаться

Направления, где API окупается быстрее всего:

• Telegram-магазины цифровых товаров — звёзды и Premium как основной ассортимент, Steam как допродажа.
• Продавцы на маркетплейсах — FunPay, Playerok и подобные площадки: выигрыш за счёт скорости выдачи и отсутствия ночных простоев.
• Донат-сервисы и сообщества — звёзды на подарки, реакции и внутренние покупки в ботах.
• Агентства и арбитраж — GRAM на аккаунт для пополнения рекламных кабинетов Telegram Ads без бирж.
• Игровые магазины и SaaS — Steam-пополнение по логину как отдельный продукт с понятной механикой 1:1.

По срокам подключение логично планировать до сезонных пиков. Ближайший — фестиваль PvE-выживания и крафта, стартовавший 31 августа 2026; дальше осенняя распродажа 1–8 октября и зимняя с 17 декабря 2026 по 4 января 2027. Полный график собран в нашем календаре распродаж Steam на 2026 год.

Спрос на Steam-направлении растёт не только в пики: за год частотность запроса «пополнить стим без комиссии» выросла примерно вдвое — с семи тысяч показов до пятнадцати с лишним. Причина устойчива: прямая оплата Steam российскими картами недоступна с 2022 года, международные платёжные системы такие операции не проводят. Ниша посредников никуда не денется, вопрос только в том, кто выдаёт быстрее.

Правовая и практическая сторона: перепродажа с наценкой — обычная розница, но играйте по правилам платформ. Не просите у клиента пароль от Steam, не собирайте seed-фразы, не обещайте того, чего Telegram не даёт. Курсы и цены плавающие, итоговая сумма всегда фиксируется в момент заказа. Это не финансовая консультация — оценивайте юнит-экономику под свой рынок сами.

Частые ошибки при запуске магазина на API

Собрал то, с чем чаще всего приходят в поддержку — сэкономит вам первую неделю.

1. Продажа по старой цене. Курс Stars и GRAM плавает; если витрина не обновляет цену, вы торгуете в минус на второй день. Запрашивайте цену перед оформлением.
2. Тариф Premium на месяц в витрине. Доступны только 3, 6 и 12 месяцев. Лишняя карточка = спор и возврат.
3. Отсутствие идемпотентности. Сеть моргнула, бот отправил повторный запрос без external_id — два заказа, один клиент.
4. Ник без проверки. Скрытый или несуществующий @username ловится за один вызов до списания.
5. Пустой партнёрский баланс в пик. В распродажу заказы идут волной; пополнение баланса в три часа ночи — не то, чем хочется заниматься.
6. Вебхук без проверки подписи. Принимать «подтверждения» от кого угодно — плохая идея, даже если снаружи это выглядит удобно.
7. Ключ в клиентском коде. Ключ живёт только на сервере.

Отдельно про коммуникацию с покупателем: люди нервничают, когда деньги ушли, а уведомления нет. Отправляйте сообщение сразу после создания заказа и второе — после подтверждения выдачи. Вопросов в чат станет ощутимо меньше.

Стоит ли переносить магазин на наше API

Если выдача у вас всё ещё ручная или поставщик отвечает «через час», переезд окупается на первой же распродаже: заказы уходят за минуты и ночью, комиссия на Fragment-товары — 1%, Steam идёт 1:1 без наценки сверху суммы пополнения. KRAB.GG работает с 2024 года, рейтинг 5/5, аптайм 99.98%, поддержка отвечает в среднем за 1–3 минуты — по деньгам и по нервам это заметно.

Разумный план: сегодня — ключ и тестовый заказ, завтра — одна категория в витрине, к 1 октября — весь ассортимент и вебхуки. Начните с документации партнёрского API и подключите ключ в @apistarsbot; остальные ответы по заказам и оплате собраны в разделе частых вопросов.