# 波場能量租賃 API 接入指南：簽章、下單與回呼

TRONow 波場能量 API 接入指南：最低 65K、即時報價、冪等下單、五種訂單狀態與 Webhook 驗簽。附公開 OpenAPI 規範與 Node.js 客戶端。

Canonical: https://tronow.io/zh-TW/guides/tron-energy-api/
Reviewed by TRONow · 2026-10-03

## 錢包購買與商戶餘額

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

## 資料中心

- [波場能量租賃教學：TRON 能量與 USDT 轉帳費用](https://tronow.io/zh-TW/guides/tron-energy-usdt/)
- [關於 TRONow：波場能量租賃與商戶 API](https://tronow.io/zh-TW/about/)
- [TRONow 能量價格、精度與付款規則](https://tronow.io/zh-TW/pricing/)
- [TRONow 常見問題：購買、充值與 API](https://tronow.io/zh-TW/faq/)
- [可靠接入 TRON 能量 API：冪等與對帳](https://tronow.io/zh-TW/guides/reliable-energy-integration/)
- [USDT 轉帳選 65,000 還是 131,000 能量？](https://tronow.io/zh-TW/guides/usdt-energy-65000-131000/)
- [租了波場能量，轉 USDT 為什麼還扣 TRX？](https://tronow.io/zh-TW/guides/usdt-transfer-troubleshooting/)
- [TRON USDT 轉帳 Energy 檔位參考](https://tronow.io/zh-TW/tools/usdt-fee-calculator/)

## 開發者接入資料

- [OpenAPI](https://tronow.io/developers/openapi.yaml)
- [Skill: authentication, idempotency, webhook verification](https://tronow.io/developers/tronow-connect/SKILL.md)
- [Node.js](https://tronow.io/developers/tronow-connect/client.mjs)
- [錯誤碼與處理](https://tronow.io/developers/errors.zh-TW.md)