stars_webserver

Teleton-плагин для покупки звезд

Tools

Tool	Эндпоинт	Описание
stars_pricelist	GET /plugin/pricelist/C4mX12qRt9Ld	Прайс (USD), партнёрская комиссия (%), курс TON/USD
stars_estimate	POST /plugin/stars-estimate	Оценка: сколько звёзд получит пользователь за amount+asset
stars_omniston_transfer_link	POST /plugin/omniston/transfer-link	Сборка Omniston quote и deeplink на TON transfer для оплаты

Схемы (параметры и ответы)

1) stars_pricelist

Ответ (HTTP 200 всегда)

Успех:

{
  "stars_price_usd": 0.0123,
  "service_fee_percent": 2.0,
  "ton_price_usd": 4.56
}

2) stars_estimate

Параметры

Param	Type	Required	Description
amount	string	Yes	Кол-во токенов в человекочитаемом виде, строкой (пример "10.5")
asset_address	string	Yes	Адрес master (jetton) или TON native master EQAAAAAAAA...AM9c

Ответ

Успех:

{
  "ok": true,
  "stars": 1234,
  "ton_receive": 1.23456789,
  "stars_ton_rate": 0.00123456
}

Ошибка:

{ "ok": false, "error": "..." }

3) stars_omniston_transfer_link

Параметры (минимально необходимые)

Param	Type	Required	Description
wallet_address	string	Yes	Адрес кошелька пользователя (source)
username	string	Yes	Username Telegram (без @)
bid_asset_address	string	Yes	Адрес jetton master, которым платим
bid_amount	string	Yes	Сумма оплаты в человекочитаемом виде (строкой)

Ответ

Успех:

{
  "ok": true,
  "quote_id": "....",
  "ton_receive": 1.23456789,
  "stars_receive": 1234,
  "links": {
    "universal": "ton://transfer/....?amount=....&bin=....&init=....&exp=....",
    "tonkeeper": "https://app.tonkeeper.com/transfer/....?....",
    "tonhub": "https://tonhub.com/transfer/....?....",
    "mytonwallet": "https://my.tt/transfer/....?...."
  }
}