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: находит получателя, получает счёт, отправляет платёж и ждёт подтверждения. Подпись остаётся за вами.
-
Fragment API
Создаёт заказ
- Находит получателя на Fragment
- Получает счёт на заказ
- Возвращает готовый запрос на оплату
-
Ваш сервер
Проверяет и подписывает
- Платит только на адреса Fragment и сервиса
- Следит за потолком комиссии и вашими лимитами
- Подписывает вашим кошельком, локально
-
Fragment API
Отправляет и подтверждает
- Проверяет то, что вы подписали
- Отправляет транзакцию в сеть TON
- Подтверждает оплату в блокчейне
Без вашей подписи не уйдёт ни один перевод
Вход без сид-фразы
Вы входите по подписи TON Connect. На нашем сервере нет ничего, чем можно подписать перевод.
Только знакомые адреса
SDK платит лишь на адреса Fragment и кошельки сервиса, и оба списка зашиты в сам SDK.
Ваш лимит на заказ
Другие ваши токены SDK не трогает и не заплатит за заказ больше лимита, который вы задали.
Первая покупка в несколько строк
Официальные SDK для Node.js и Python сами проверяют, подписывают и отправляют каждый платёж.
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
import os from fragment_api_lib.v3 import FragmentAPIv3 api = FragmentAPIv3( mnemonic=os.environ["TON_SEED"], # подписывает здесь, никуда не отправляется wallet_type="v5r1", # или "v4r2" fragment_cookies=os.environ["FRAGMENT_COOKIES"], # ваш аккаунт Fragment (KYC) trust={"max_ton_per_order": 50}, # не подписывать ничего дороже ) result = api.buy("stars", "durov", 50) # нет аккаунта Fragment? добавьте kyc=False
Фиксированная комиссия за заказ, без подписки
Не нужны ни регистрация, ни API-ключ. Для покупки хватит кошелька TON.
Ваш аккаунт Fragment
С KYC-верификацией на fragment.com
- Оплата в TON или USDT в сети TON
- Stars, Premium и TON
- Комиссия уходит в той же транзакции, что и платёж
Без 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 и сделайте первую покупку. Это займёт несколько минут.