Telegram API

Звёзды, Premium и GRAM — через API

Продавайте Telegram Stars, Premium и пополнения GRAM в своём сервисе. Один REST-запрос — заказ выполнен через Fragment, статус приходит webhook-ом.

Документация API Купить звёзды

TON и USDT (TON)
Webhook-и
OpenAPI на русском

Что можно продавать

Telegram Stars

От 50 звёзд на любой username. Выдача через Fragment за минуту.

Telegram Premium

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

Пополнение GRAM

TON на кошелёк Telegram-аккаунта — от 1 GRAM.

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

1
Выпустите токен
Откройте @GeteoraApiBot — API-токен и webhook-токен выдаются за пару нажатий.
2
Пополните баланс
TON или USDT (TON) на общий адрес с вашим memo — зачисление после подтверждения в сети.
3
Создайте заказ
Один запрос POST /v1/order — товар уходит получателю, статус приходит webhook-ом.

Оплата с баланса

Списываем TON или USDT с API-баланса — без счёта на каждый заказ.

Webhook-и с подписью

HMAC-SHA256, повторы с экспоненциальной паузой, ручная переотправка.

Идемпотентность

Idempotency-Key защищает от двойной покупки при повторе запроса.

Прямые счета

Нужно принять оплату от клиента? Заказ без баланса с собственным счётом в TON/USDT.

curl https://api.geteora.org/v1/order \
  -H "X-API-TOKEN: $GETEORA_TOKEN" \
  -H "Idempotency-Key: order-1042" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "stars",
    "quantity": 100,
    "recipient": "durov",
    "use_wallet": true,
    "currency": "ton"
  }'

Тарифы

Чем больше оборот — тем ниже комиссия

Уровень считается по завершённым заказам с API-баланса за 30 дней. С ростом оборота снижается комиссия и растёт лимит запросов в секунду. Для крупных объёмов — индивидуальные условия.

Посмотреть в @GeteoraApiBot Документация на русском