錢包購買與商戶餘額
註冊商戶帳戶後,在商戶後台「充值」查看專屬 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 參考價不代表所有帳戶擁有相同產品或價格。請以帳戶即時報價為準,先驗證完整訂單流程,再逐步擴大業務,並觀察餘額、失敗訂單及回呼。