TRONow商户后台 →
TRONow · Merchant API

通过 API 稳定完成波场能量下单

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

官网购买由钱包转入一笔准确的 TRX 金额;商户购买从账户内部余额支付。每个商户有独立充值地址,确认充值后增加该商户余额,不会自动生成能量订单。商户后台购买与 OpenAPI 使用同一套报价和下单流程。

先为准确的数量获取报价

按照实际购买的资源类型、数量、租期请求报价。价格会波动,大额订单也不一定等于单份价格乘以份数。请使用返回的准确总额和 quote_id。商户报价有效期为 1 分钟;提交前过期时,应重新获取报价。

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

创建订单时提交报价中的产品、接收钱包、quote_id 和自己的 client_order_id。同一业务请求使用同一个 Idempotency-Key。响应超时后,应使用原始参数和原始幂等键重试,或查询订单;不要仅因响应丢失就换新键再次购买。

已接收,不等于已交付

接口接收订单后,后台才开始处理。请通过返回的订单号查询状态,或接收经过签名校验的 Webhook。确认最终交付状态与链上凭证后,再把能量视为可用。状态不确定时应等待核查,不应自动重复下单。

保护凭证与回调

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

按实际账户报价评估价格

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