TRONENS API

Формат ответа

Настоящий ответ API всегда имеет success и, при успехе, data. При ошибке возвращается error с машинным кодом. Диагностический тестовый файл дополнительно показывает method, url, http_code, duration_ms, request, response и curl_error — эти поля не являются частью публичного API. Реальный ответ TRONENS находится внутри response тестера.

{
  "success": true,
  "data": { ... }
}

{
  "success": false,
  "error": "ERROR_CODE"
}

Авторизация

Authorization: Bearer te_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

Передавайте Bearer token в заголовке Authorization. Ключ создаётся в ЛК и полностью показывается только один раз.

Для каждого ключа можно задать IP whitelist, лимит запросов в минуту и срок действия. Ответы содержат X-RateLimit-Limit и X-RateLimit-Remaining; при 429 также Retry-After.

Цена

Возвращает цену для клиента с учётом персональной скидки.

GET /api/v1/quote/?package_id=1&duration_minutes=15
GET /api/v1/quote/?energy_amount=65000&duration_minutes=60

Пример ответа

{
  "success": true,
  "data": {
    "type": "custom",
    "energy_amount": 65000,
    "duration_minutes": 60,
    "base_price_trx": 1.961,
    "discount_percent": 0,
    "discount_trx": 0,
    "price_trx": 2.05
  }
}

Расчёт Energy

Оценивает необходимый объём Energy для указанного TRON-адреса.

{
  "recipient_address": "T...",
  "has_usdt": true
}

Пример ответа

{
  "success": true,
  "data": {
    "estimated_energy": 65000,
    "recommended_package": {
      "id": 1,
      "name": "65 000 Energy",
      "energy_amount": 65000,
      "duration_minutes": 15
    }
  }
}

Создание заявки

Создаёт реальную заявку и списывает рассчитанную сумму с баланса TRX аккаунта. Адрес получателя должен быть активирован в сети TRON до создания заявки. Новые API-заявки принимаются асинхронно и возвращают HTTP 202. external_id рекомендуется передавать всегда: повтор того же значения вернёт существующую заявку без второго списания.

{
  "external_id": "merchant_93481",
  "package_id": 1,
  "duration_minutes": 15,
  "address": "T..."
}

Пример ответа

HTTP 202
{
  "success": true,
  "data": {
    "order_id": 123,
    "external_id": "merchant_93481",
    "status": "processing",
    "idempotent": false
  }
}

Статус заявки

Возвращает актуальные данные и статус заявки.

GET /api/v1/status/?id=123
GET /api/v1/status/?external_id=merchant_93481

Поля времени возвращаются в формате YYYY-MM-DD HH:MM:SS во временной зоне сервера TRONENS.

Пример ответа

{
  "success": true,
  "data": {
    "id": 123,
    "external_id": "merchant_93481",
    "address": "T...",
    "energy_amount": 65000,
    "duration_minutes": 15,
    "price_trx": 1.14,
    "status": "delegated",
    "txid": "...",
    "refunded": false,
    "error_code": null,
    "created_at": "2026-10-03 18:01:00",
    "delivered_at": "2026-10-03 18:01:12",
    "completed_at": null,
    "updated_at": "2026-10-03 18:01:12"
  }
}

Статус

Баланс

Текущий доступный баланс аккаунта в TRX.

{"success":true,"data":{"balance_trx":125.5}}

Webhook

Webhook передаёт данные заявки при изменении её статуса. Проверяйте подпись по исходному JSON-телу и webhook secret.

X-Webhook-Event: order.delegated
X-Webhook-Id: order-123-order.delegated-...
X-Webhook-Signature: sha256=<hex_hmac>

expected = HMAC_SHA256(raw_json_body, webhook_secret)

{
  "event": "order.delegated",
  "event_id": "order-123-order.delegated-...",
  "created_at": "2026-10-03T15:01:12Z",
  "data": {
    "order_id": 123,
    "external_id": "merchant_93481",
    "address": "T...",
    "energy_amount": 65000,
    "duration_minutes": 15,
    "price_trx": 1.14,
    "status": "delegated",
    "txid": "...",
    "refunded": false,
    "error_code": null,
    "created_at": "2026-10-03 18:01:00",
    "delivered_at": "2026-10-03 18:01:12",
    "completed_at": null,
    "updated_at": "2026-10-03 18:01:12"
  }
}

События: order.processing, order.delegating, order.delegated, order.undelegating, order.completed, order.review, order.failed. HTTP 2xx считается успешной доставкой; временные ошибки повторяются до 8 раз с увеличением паузы. Удаляйте дубли по event_id.

Ошибки

Коды error предназначены для программной обработки. Используйте HTTP-статус и значение поля error.