TRONow
语言 · 简体中文
商户后台 →
TRONow · 开发者

波场能量租赁 API 接入指南:签名、下单与回调

TRONow 波场能量 API 接入指南:最低 65K,实时报价、幂等下单、五种订单状态与 Webhook 验签。附公开 OpenAPI 规范及 Node.js 客户端。

TRONow 审阅

开发者接入资料

公开接口规范与服务端参考客户端,无需登录即可阅读;实际调用 API 仍需已开通的商户账户。

AI 接入 Skill ↓

OpenAPI 接口规范 · HTTP API

https://api.tronow.io/openapi/v1

HTTPAPI
GET/prices/quote
POST/orders
GET/orders
GET/orders/{order_id}
POST/address-activations
GET/address-activations
GET/address-activations/{activation_id}
GET/account/balance

钱包直购和商户余额有什么区别

注册商户账户后,在商户后台「充值」查看专属 TRON 主网地址。只支持原生 TRX,每笔至少 10 TRX,低于此金额不入账。累计入账达到 20 TRX 后,API 与商户后台购买同时解锁。充值只增加余额,不会自动生成能量订单;每笔订单仍需有足够的可用余额。

最低 65K,先为准确数量获取报价

最低下单量为 65,000 Energy(65K)。API 报价和下单的 resource_amount 均须为不小于 65000 的整数,自定义数量同样适用。32K、64K 等低于最低数量的请求返回 422 UNSUPPORTED_PRODUCT,请修改数量后再请求。按照准确的资源类型、数量和租期获取实时报价。响应会返回 price_sun、currency 和 priced_at;price_sun 是整数 SUN 字符串,用于展示当前参考价,请勿写死价格。POST /orders 受理时会重新计算并锁定该笔订单价格,不需要提交报价编号。

一个业务订单,只创建一次

创建订单时提交资源类型、数量、租期、接收钱包和自己的 client_order_id。同一业务请求使用同一个 Idempotency-Key。受理响应会返回平台订单号和已锁定的冻结金额;响应超时后,应使用原始参数和原始幂等键重试,或查询订单,不要仅因响应丢失就换新键再次购买。

能量订单的五种状态如何判断

HTTP 受理成功不代表能量已可用。请查询订单或处理验签后的 Webhook。CONFIRMING 已有哈希,可在 TRONSCAN 查看;稳妥起见,等待 SUCCESS 或确认钱包可用能量后再转账。SUCCESS 表示已在 TRON 查到该哈希,不代表之后的 USDT 转账已经成功。结果不确定时,不要重复创建订单。

API 状态含义资金处理
PROCESSING正在处理,尚无交易哈希。冻结中
CONFIRMING已获得哈希,正在异步查询链上交易。冻结中
SUCCESS已在 TRON 查到该哈希。按锁定订单金额扣款
FAILED订单处理失败并结束。已释放冻结金额
REVIEWING结果尚不确定,需要人工核查。继续冻结,等待处理

保护凭证与回调

API Secret 保存在自己的服务器端,配置允许访问的来源 IP,并校验 Webhook 签名。日志保留必要的订单标识和排查信息,不记录完整凭证。回调可能重复投递,消费方需要按事件实现幂等处理。

按实际账户报价评估价格

官网展示的是标准 API 参考价,不代表所有账户拥有相同产品和价格。您的账户实时报价才是成交依据。先用受支持的数量验证完整订单生命周期,再逐步扩大业务,并观察余额、失败订单和回调处理情况。