Разработчикам · 2026

API для Telegram Stars, Premium и TON

Отправляйте Stars, Premium и пополнения TON по @username из магазина, бота или CRM через HTTP API OREO.TG. Идемпотентность, тестовая среда (sandbox), вебхуки по статусам. Цены обновляются в реальном времени по курсу TON.

Быстрый пример

POST https://api.oreo.tg/v1/orders
Content-Type: application/json
Idempotency-Key: 6f1f3c0b-7c9b-4e3e-9b7c-91a4...
Authorization: Bearer YOUR_API_KEY

{
  "categoryId": "stars",
  "amount": 100,
  "recipientUsername": "@example"
}

Идемпотентные ключи

Отправляйте Idempotency-Key в каждом POST — заказ не задвоится даже при ретраях и обрывах сети.

Тестовая среда

Полноценная sandbox-среда для прогона тестов. Без расхода реальных Stars и TON.

Вебхуки

События «создан / оплачен / доставлен / возврат» приходят на ваш URL с HMAC-подписью. Без long-polling.

Цены в реальном времени

Получаете котировку, фиксируете на 60 секунд и списываете с клиента точный тариф. Без сюрпризов с курсом TON.

OpenAPI 3.1

Готовые клиенты для TypeScript, Python, Go и PHP из OpenAPI 3.1. SDK-стартеры для Node и Python.

Индивидуальный SLA

От 100 заказов в месяц — выделенные лимиты, SLA 99.95%+, приоритетная поддержка и персональный менеджер.

Основные эндпоинты

  • GET/v1/categoriesСписок товаров и тарифных уровней
  • POST/v1/ordersСоздать заказ из пресета (Stars / Premium / TON)
  • GET/v1/orders/:labelСтатус заказа: получатель, сумма, таймлайн
  • POST/v1/orders/:label/payСоздать платёжную сессию
  • POST/v1/orders/:label/refundПолный или частичный возврат
  • GET/v1/balanceБаланс аккаунта и лимиты партнёра

Нужен доступ?

Напишите в Telegram @helIo_stars. Выдадим API-ключ, пришлём документацию и обсудим объёмные тарифы.

Подключить API →