交易狀態與重試
提現是一項異步業務操作。HTTP 響應成功表示請求得到了處理,並不能證明資金已經在鏈上到賬。
持久化一個業務編號
發送提現前生成並保存 client_request_id。同一筆預期操作的重試,包括進程重啟後的重試,都應複用它,並保持交易字段一致。當前實現會拒絕同一編號下業務參數衝突的重複請求。
不要只依賴 Idempotency-Key 請求頭。配套 SDK 可以添加該頭,但當前提現去重契約以請求體中的 client_request_id 為依據。
理解請求數據
此表說明核心字段,不是完整請求結構。預覽、費用確認和不同託管方式的要求,需要按接入版本核對。避免使用二進制浮點數表示金額,也不要跨環境照搬示例中的鏈或資產編號。
跟蹤處理結果
以上為示例,狀態集合可能繼續演進。遇到未知狀態應保留原值並跟進,不能直接當作成功或失敗。僅憑“失敗”或“駁回”標籤,也不足以證明交易從未簽名或廣播。
超時後的處理
通過 GET /api/v1/withdrawals/by-request 查詢,在查詢參數中傳入原來的 client_request_id。結果不明確時,繼續查詢或對賬原操作。如果需要更新授權,仍使用同一編號,並按約定流程續期。
是否允許取消取決於真實簽名階段和服務端檢查。只有確認原交易未轉出、且之後也不可能轉出時,才發起替代的業務操作。通過 Webhook 接收事件,同時保留 API 查詢作為對賬途徑。