跳到导航

交易状态与重试

以 Markdown 格式查看

提现是一项异步业务操作。HTTP 响应成功表示请求得到了处理,并不能证明资金已经在链上到账。

持久化一个业务编号

发送提现前生成并保存 client_request_id。同一笔预期操作的重试,包括进程重启后的重试,都应复用它,并保持交易字段一致。当前实现会拒绝同一编号下业务参数冲突的重复请求。

不要只依赖 Idempotency-Key 请求头。配套 SDK 可以添加该头,但当前提现去重契约以请求体中的 client_request_id 为依据。

理解请求数据

字段含义
chain_id、asset_id约定环境中的网络与资产编号
to_address、amount目标地址,以及用字符串表示的正十进制金额
client_request_id稳定的业务请求编号
dest_memo_type、dest_memo网络要求的目标备注信息
client_authorization通过 API 密钥发起提现时的客户交易授权
end_user_id企业 API 流程中可选的业务用户编号

此表说明核心字段,不是完整请求结构。预览、费用确认和不同托管方式的要求,需要按接入版本核对。避免使用二进制浮点数表示金额,也不要跨环境照搬示例中的链或资产编号。

跟踪处理结果

状态示例含义
pending_approval、pending_platform_review等待业务审批或复核
approved、pending_sign审批与签名处于不同阶段
broadcasting、pending_chain正在广播或等待链上确认
broadcast_unverified、recovering结果仍不确定,不应另发一笔
awaiting_reauthorization可能需要为原请求重新提供客户授权
confirmed系统已记录链上确认结果

以上为示例,状态集合可能继续演进。遇到未知状态应保留原值并跟进,不能直接当作成功或失败。仅凭“失败”或“驳回”标签,也不足以证明交易从未签名或广播。

超时后的处理

通过 GET /api/v1/withdrawals/by-request 查询,在查询参数中传入原来的 client_request_id。结果不明确时,继续查询或对账原操作。如果需要更新授权,仍使用同一编号,并按约定流程续期。

是否允许取消取决于真实签名阶段和服务端检查。只有确认原交易未转出、且之后也不可能转出时,才发起替代的业务操作。通过 Webhook 接收事件,同时保留 API 查询作为对账途径。