错误响应代码

API 用标准 code 表示结果。按 code 分支处理，不要只看 message 文案。

标准响应代码

code	含义	你该怎么做
00	成功	更新本地订单，给用户成功反馈，记审计日志
01	处理中	用 inquiry 轮询状态；设合理超时，勿死等
10	错误请求	核对必填字段、类型与请求结构
11	未找到	核对 endpoint、orderNo / tradeNo、API 版本
12	未授权	核对签名、密钥与支付方式配置 → 签名规则
13	请求过多	降频；指数退避重试
14	禁止访问	查账户 / 支付方式状态；联系商务
15	超时	查网络与可用性；递增延迟重试
16	余额不足	下单前校验余额；给用户明确提示
99	系统 / 渠道错误	记录完整响应与 requestId；可短重试，仍失败联系技术支持

响应体示例

{
  "code": "10",
  "message": "错误请求",
  "details": "缺少必需参数: merchantId",
  "timestamp": "2020-12-17T10:55:00-05:00",
  "requestId": "req_123456789"
}

落地要点

1. 按 code 分支 — 文案可能变，码值稳定。
2. 可重试再重试 — 01 / 15 / 部分 99；10–14、16 先修请求或配置。
3. 日志 — 至少记 code、requestId、业务单号。
4. 幂等 — 重试或回调重复到达时，同一订单勿重复入账。

客服排查 code + responseCode：见 Customer RAG。