交易状态与重试
提现是一项异步业务操作。HTTP 响应成功表示请求得到了处理,并不能证明资金已经在链上到账。
持久化一个业务编号
发送提现前生成并保存 client_request_id。同一笔预期操作的重试,包括进程重启后的重试,都应复用它,并保持交易字段一致。当前实现会拒绝同一编号下业务参数冲突的重复请求。
不要只依赖 Idempotency-Key 请求头。配套 SDK 可以添加该头,但当前提现去重契约以请求体中的 client_request_id 为依据。
理解请求数据
此表说明核心字段,不是完整请求结构。预览、费用确认和不同托管方式的要求,需要按接入版本核对。避免使用二进制浮点数表示金额,也不要跨环境照搬示例中的链或资产编号。
跟踪处理结果
以上为示例,状态集合可能继续演进。遇到未知状态应保留原值并跟进,不能直接当作成功或失败。仅凭“失败”或“驳回”标签,也不足以证明交易从未签名或广播。
超时后的处理
通过 GET /api/v1/withdrawals/by-request 查询,在查询参数中传入原来的 client_request_id。结果不明确时,继续查询或对账原操作。如果需要更新授权,仍使用同一编号,并按约定流程续期。
是否允许取消取决于真实签名阶段和服务端检查。只有确认原交易未转出、且之后也不可能转出时,才发起替代的业务操作。通过 Webhook 接收事件,同时保留 API 查询作为对账途径。