# 可靠接入 TRON 能量 API：冪等與對帳

透過業務訂單號、整數 SUN、超時查單與回呼去重，建立可追蹤的能量訂單流程，避免重複提交和狀態誤判。

Canonical: https://tronow.io/zh-TW/guides/reliable-energy-integration/
Reviewed by TRONow · 2026-09-12

## 先保存業務訂單

生成唯一 client_order_id，先在資料庫保存數量、租期與接收地址，並建立唯一約束。本文是接入參考，不是客戶案例。

## 保存完整報價

GET /prices/quote 必須對應實際數量與租期。一起保存 quote_id、金額及 expires_at，金額使用整數 SUN 字串或精確數值類型。變更參數須重新報價。

## 簽名與請求一致

憑據只保留在伺服器。將 JSON 序列化一次，依規範對實際傳送位元組簽名。日誌隱藏密鑰和認證標頭。

## 同時保存冪等鍵

POST /orders 除 client_order_id 外，還要求 8–128 個可見 ASCII 字元的 Idempotency-Key。提交前保存鍵值及原始請求。重試不確定結果時保持兩者不變，重新生成時間戳、nonce 與簽名。先確認舊請求結果，再處理過期報價。Webhook 規則見公開 Skill，地址啟動沒有回呼，需查詢結果。

## 超時先查單

POST /orders 超時後，先以 GET /orders?client_order_id={client_order_id} 查詢。已有訂單繼續追蹤，適合重試時保留相同編號與參數，冪等衝突應排查。

## 受理與完成分開

保存平台訂單號與狀態，依据終態和交付證據更新本地紀錄，HTTP 成功不能視為已委託。失敗與待審核狀態保留給人員處理。

## 回呼驗簽與去重

按規範驗證 Webhook，依事件編號去重，可靠保存或處理後再回覆。容忍重複通知，狀態不一致時透過查單對帳。

## 限制重試並驗證異常

使用超時、指數退避及有限重試。記錄不含秘密的訂單狀態變化。上線前檢查餘額不足、過期報價、重複訂單、超時與錯誤簽名；實際傳輸格式以下方規範為準。

## 資料中心

- [波場能量是什麼？USDT 轉帳為何需要能量？](https://tronow.io/zh-TW/guides/tron-energy-usdt/)
- [透過 API 穩定完成波場能量下單](https://tronow.io/zh-TW/guides/tron-energy-api/)
- [關於 TRONow：波場能量租賃與商戶 API](https://tronow.io/zh-TW/about/)
- [TRONow 能量價格、精度與付款規則](https://tronow.io/zh-TW/pricing/)
- [TRONow 常見問題：購買、充值與 API](https://tronow.io/zh-TW/faq/)

## 開發者接入資料

- [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)