重试与回退策略
— 网络/服务端错误 —
- 429/5xx:指数退避(基 250ms,最大 4 次,+ 随机抖动 0-100ms),Pacifica 客户端已实现。
— 业务错误(示例) —
- 精度/超限(-1111/-4005/-1013):
- 余额不足(-2019):
- 状态受限(403):
- 文档化排查(CDN/白名单);可退回 WS 或历史回退方案(如启用)。
— 幂等与去重 —
client_order_id
使用 UUID,服务端侧若去重会降低重复下单风险;
- 撤单/批量动作建议在客户端增加“已受理”缓存,短时重复提交直接返回。