TRONowОплата кошельком и баланс
Зарегистрируйте аккаунт и откройте раздел пополнения в кабинете: там указан ваш персональный адрес в основной сети TRON. Отправляйте только нативный TRX, не менее 10 TRX за перевод; меньшие суммы не зачисляются. API и покупки в кабинете открываются после суммарного зачисления 20 TRX. Пополнение увеличивает баланс, но не создаёт заказ энергии. Для каждого заказа нужен достаточный доступный баланс.
Минимум 65K: запросите цену на точное количество
Минимальный заказ — 65 000 Energy (65K). Для котировок и заказов API, включая произвольные объёмы, укажите целое resource_amount не менее 65000. Меньшие положительные значения возвращают 422 UNSUPPORTED_PRODUCT; исправьте количество перед повтором. Запросите текущую цену для точных типа ресурса, количества и срока. Ответ содержит price_sun, currency и priced_at; price_sun — целая строка SUN для отображения текущей справочной цены. Не фиксируйте цену в коде. POST /orders повторно рассчитывает и фиксирует цену при принятии заказа, поэтому идентификатор котировки не нужен.
Один заказ — один ключ
Передайте тип ресурса, количество, срок, кошелёк получателя и client_order_id. Один логический запрос использует один Idempotency-Key. Ответ о принятии содержит номер заказа платформы и зафиксированную зарезервированную сумму. После тайм-аута повторите исходный запрос с тем же ключом или проверьте заказ; потерянный ответ не является основанием для новой покупки.
Пять состояний заказа энергии
Успешный HTTP-ответ означает приём заказа, а не готовность энергии. Проверяйте заказ через API или подписанные вебхуки. В CONFIRMING уже есть хеш для просмотра в TRONSCAN. Для более безопасного перевода дождитесь SUCCESS или проверьте доступную энергию кошелька. SUCCESS означает, что хеш найден в TRON, а не успех последующего перевода USDT. Не создавайте новый заказ при неопределённом результате.
| Статус API | Значение | Средства |
|---|---|---|
| PROCESSING | Обработка; хеша пока нет. | Зарезервированы |
| CONFIRMING | Хеш получен; идёт асинхронная проверка в сети. | Зарезервированы |
| SUCCESS | Хеш найден в TRON. | Списана зафиксированная сумма заказа |
| FAILED | Заказ завершён с ошибкой. | Резерв освобождён |
| REVIEWING | Результат неясен; нужна проверка оператором. | Остаются в резерве до решения |
Защитите интеграцию
Храните API Secret на своём сервере, настройте разрешённые IP и проверяйте подпись Webhook. Не записывайте полные секреты в журналы. Уведомления могут повторяться; обработчик должен быть идемпотентным.
Проверяйте цену аккаунта
Публичная цена API — стандартный ориентир. Продукты и итоговая цена аккаунтов могут отличаться. Начните с поддерживаемого объёма, проверьте весь цикл заказа, затем увеличивайте нагрузку, отслеживая баланс, ошибки и обработку уведомлений.