错误与重试
根据 HTTP 状态和错误信息,定位问题并安全重试。
响应结构
{"error": "invalid signature"}当前接口使用 HTTP 状态与 error 文本描述失败,没有额外的数字业务错误码。
| HTTP 状态 | 常见含义 | 建议处理 |
|---|---|---|
| 400 | 参数不完整、金额或地址无效 | 检查参数后重新提交 |
| 401 | 鉴权失败、时间戳无效、请求重放 | 按下表检查签名与凭据 |
| 403 | 商户尚未激活等访问限制 | 联系平台管理员核查状态 |
| 404 | 当前商户下不存在该资源 | 核对平台 UUID 与所属商户 |
| 409 | 主钱包未配置、业务编号冲突等 | 解决配置或幂等冲突后再提交 |
| 500 | 内部处理失败 | 保存脱敏请求信息,稍后重试或联系管理员 |
| 503 | 钱包或密钥服务配置不可用 | 联系平台管理员处理 |
常见错误
| 错误信息 | 排查方向 |
|---|---|
API authentication required | 是否缺少四个鉴权请求头 |
invalid timestamp | 是否使用秒级时间戳,时钟误差是否超过 300 秒 |
invalid credentials | API Key 是否有效、是否已撤销、商户是否激活 |
invalid signature | Secret、路径、请求体字节与拼接格式是否一致 |
replayed request | 是否复用了 Nonce |
merchant settlement wallet not configured | 是否配置有效商户主钱包 |
customer deposit address not configured | 是否先创建了该用户及对应资产的充值地址 |
order already exists with different data | 是否对同一订单号提交了不同参数 |
same deposit address already has an active order for this amount | 同一地址同一金额是否已有待支付订单 |
请求超时后如何处理
超时不能说明请求没有成功。创建用户时复用原 external_id,创建订单时复用原 order_no,提现时复用原幂等键。每次 HTTP 重试都生成新的 Nonce、时间戳和签名。
不要在失败后随意更换业务编号,以免把重试变成新业务。已有订单 UUID 时,应先查询状态。
提交排查信息
请提供发生时间、请求路径、HTTP 状态、错误文本、业务编号和交易哈希。隐藏 API Secret、回调密钥、密码、私钥及完整鉴权头。
账户或收款操作问题可先查看帮助中心的常见问题。