钱包直购和商户余额有什么区别
注册商户账户后,在商户后台「充值」查看专属 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 参考价,不代表所有账户拥有相同产品和价格。您的账户实时报价才是成交依据。先用受支持的数量验证完整订单生命周期,再逐步扩大业务,并观察余额、失败订单和回调处理情况。