ZeroPay

错误码

响应结构与错误码说明。

所有响应使用统一结构:code(0 表示成功)、msg、data。错误同时保留有语义的 HTTP 状态码。

错误示例
{
  "code": 40000,
  "msg": "no receiving address configured for chain \"base\"; set it in the Boss console first"
}
codeHTTP含义
0200成功
40000400校验失败——链/资产不支持、地址格式错误、金额超限、未配置收款地址等
40100401凭证缺失或无效(JWT、API Key 或 Privy token)
40300403已认证但无权限
40400404订单或资源不存在(或属于其他账户)
42900429触发限流——请降低频率
50000500内部错误——可携带相同 external_id 安全重试
  • 报价失败会以 400 返回,msg 中包含上游原因(例如金额低于该路径最小值)。
  • 订单创建按 external_id 幂等——重试不会重复扣款。
错误码 · Docs · ZeroPay