Telegram Stars и Premium из вашего кода

API покупает звёзды, Premium и TON на fragment.com для любого юзернейма. Платёж подписывает ваш кошелёк, поэтому сид-фраза остаётся у вас.

Пример заказа: 500 Stars для @durov, 2.84 TON, подписано вашим кошельком и оплачено в сети TON.

Что умеет API

Stars, Premium и TON в одном API. Мы делали его для ботов и магазинов, которые продают круглосуточно.

  • Telegram Stars

    Звёзды на любой юзернейм, от 50 штук за заказ.

    product: "stars"
  • Telegram Premium

    Подписка в подарок на 3, 6 или 12 месяцев.

    product: "premium"
  • TON на юзернейм

    Отправка TON на любой юзернейм в Telegram, от 1 TON.

    product: "ton"
  • С KYC или без

    Покупайте со своего верифицированного аккаунта Fragment. Нет аккаунта? Купим через наш.

    kyc: false
  • Сид-фраза остаётся у вас

    SDK проверяет каждый платёж и подписывает его у вас. Сервер никогда не видит сид-фразу.

    API v3
  • Пакетная оплата

    Одна подписанная транзакция оплачивает сразу много заказов. С кошелька W5 это больше сотни.

    v5r1
  • Безопасные повторы

    Отправьте запрос ещё раз с тем же ключом, и вернётся тот же заказ, а не новая покупка.

    idempotency_key
  • TON или USDT

    Оплачивайте в TON, а со своим аккаунтом Fragment ещё и в USDT в сети TON.

    payment_method

Мы готовим платёж, вы его подписываете

API делает всё, что связано с Fragment: находит получателя, получает счёт, отправляет платёж и ждёт подтверждения. Подпись остаётся за вами.

  1. Fragment API

    Создаёт заказ

    • Находит получателя на Fragment
    • Получает счёт на заказ
    • Возвращает готовый запрос на оплату
  2. Ваш сервер

    Проверяет и подписывает

    • Платит только на адреса Fragment и сервиса
    • Следит за потолком комиссии и вашими лимитами
    • Подписывает вашим кошельком, локально
  3. Fragment API

    Отправляет и подтверждает

    • Проверяет то, что вы подписали
    • Отправляет транзакцию в сеть TON
    • Подтверждает оплату в блокчейне

Без вашей подписи не уйдёт ни один перевод

Вход без сид-фразы

Вы входите по подписи TON Connect. На нашем сервере нет ничего, чем можно подписать перевод.

Только знакомые адреса

SDK платит лишь на адреса Fragment и кошельки сервиса, и оба списка зашиты в сам SDK.

Ваш лимит на заказ

Другие ваши токены SDK не трогает и не заплатит за заказ больше лимита, который вы задали.

Первая покупка в несколько строк

Официальные SDK для Node.js и Python сами проверяют, подписывают и отправляют каждый платёж.

$npm install fragment-api
import { FragmentAPIv3 } from "fragment-api";

const api = new FragmentAPIv3({
  mnemonic: process.env.TON_SEED,                 // подписывает здесь, никуда не отправляется
  walletType: "v5r1",                             // или "v4r2"
  fragmentCookies: process.env.FRAGMENT_COOKIES,  // ваш аккаунт Fragment (KYC)
  trust: { maxTonPerOrder: 50 },                  // не подписывать ничего дороже
});

const result = await api.buy({ product: "stars", username: "durov", amount: 50 });
// нет аккаунта Fragment? добавьте  kyc: false

Фиксированная комиссия за заказ, без подписки

Не нужны ни регистрация, ни API-ключ. Для покупки хватит кошелька TON.

3%от суммы заказа

Без KYC

Аккаунт Fragment не нужен

  • Покупка через наш верифицированный аккаунт
  • Stars, Premium и TON
  • Комиссия входит в тот единственный платёж, который вы подписываете

Сетевые комиссии TON платит ваш кошелёк, как при любом переводе. Есть вопросы по комиссиям? Напишите нам.

Частые вопросы

Не нашли ответ? Напишите разработчику в Telegram.

Нужен ли свой аккаунт на Fragment?

Нет. Если у вас есть свой аккаунт Fragment с KYC, комиссия 2%. Если нет, мы купим через наш верифицированный аккаунт за 3%, а от вас нужен только кошелёк TON.

Отправляется ли моя сид-фраза на сервер?

Нет. В API v3 SDK подписывает каждый платёж у вас и отправляет только подписанное сообщение. Вход идёт по подписи TON Connect, так что на сервере нет ничего, чем можно потратить ваши деньги.

Какие кошельки поддерживаются?

Кошельки TON v4r2 и W5 (v5r1). Для больших объёмов лучше W5: одна транзакция оплачивает больше сотни заказов.

Что, если результат платежа неясен?

Заказ остаётся в обработке, пока результат не подтвердится в блокчейне. Мы не помечаем его как неудачный и не оплачиваем заново наугад. Отправить тот же подписанный платёж ещё раз всегда безопасно: дважды он не пройдёт.

Как получить поддержку?

Напишите разработчику в Telegram. Все методы API описаны в документации.

Хотите попробовать?

Откройте документацию, установите SDK и сделайте первую покупку. Это займёт несколько минут.