錢包購買與商戶餘額
官網購買由錢包支付準確 TRX 金額;商戶購買從內部餘額支付。每位商戶有獨立儲值地址,確認後增加餘額,不會自動建立能量訂單。商戶後台與 OpenAPI 使用相同報價及下單流程。
先取得準確數量的報價
依資源類型、數量及租期請求報價。價格會波動,大額訂單未必等於單份價格乘以份數。請使用回傳的準確總額和 quote_id。報價有效期為 1 分鐘;提交前若已過期,請重新報價。
每筆業務訂單只建立一次
提交報價產品、接收錢包、quote_id 及 client_order_id。同一業務請求使用相同 Idempotency-Key。回應逾時後請以原始參數和冪等鍵重試或查詢訂單,不要只因回應遺失就用新鍵重複購買。
已接收不代表已交付
接收訂單後才開始處理。請用訂單號查詢,或接收並驗證 Webhook。確認最終交付狀態與鏈上憑證後再使用能量。結果不確定時應等待核查,而非自動重複下單。
保護憑證與回呼
API Secret 應保存在伺服器端,設定允許的來源 IP 並驗證 Webhook 簽名。日誌保留必要訂單識別,不記錄完整憑證。回呼可能重複投遞,接收方需實作冪等處理。
以帳戶實際報價評估
官網 API 參考價不代表所有帳戶擁有相同產品或價格。請以帳戶即時報價為準,先驗證完整訂單流程,再逐步擴大業務,並觀察餘額、失敗訂單及回呼。