Guides
  1. Getting Started

错误码

统一响应信封与网关/业务错误码表

错误码

统一响应信封

所有业务接口返回同一结构：

{ "code": 200, "message": "操作成功", "data": { } }
  • code：200 表示成功；非 200 为业务/系统错误（网关业务错误常为 5 位分段码）
  • message：可读提示
  • data：成功时的业务数据；出错时可能为 null
  • 部分网关错误另含 requestId，便于排查

鉴权网关（HTTP 状态）

签名/鉴权在业务之前，由网关直接返回 HTTP 状态：

HTTP含义常见原因
400参数错误缺少/非法 X-Timestamp、缺少 X-Nonce
401未授权Access Key 无效、RSA 验签失败
403禁止访问未开通 API、IP 不在白名单、子账户凭证、账户禁用
409重复请求报文重放（相同签名 5 分钟内再次出现）
429过于频繁凭证限流；或假请求 IP 失败次数过多

业务分段码（信封 code，开放网关）

code含义处理建议
200成功—
401xx鉴权失败（若走到业务层）检查密钥/时间/签名
402xx参数错误检查 body/query；写接口是否缺 X-Idempotency-Key
403xx状态不允许如已冻结/已销卡
40401资源不存在卡/组/交易 ID 错误或不属于本商户（统一 404 防枚举）
40901幂等冲突同幂等键不同 body；换新 key 或原样重放
40902幂等处理中稍后用相同 key 查询/重试
42201资产不足充值 USD 或数字货币；系统会自动兑币，仍不足再报此码
42202BIN 不在允许范围先 GET /card-products 再开卡
42203卡预付余额不足调小转出金额
42901敏感接口限流/secure 60 次/分钟，退避重试
500xx平台内部错误带 requestId 联系平台
502xx上游异常（可重试）写接口带同一幂等键重试

处理建议

  1. 先看 HTTP 状态：401/403/429 多半是鉴权/限流，请求未进业务。
  2. 再看信封 code：4xx 修正后重试；5xx/502 退避 + 幂等键。
  3. 不要在前端用假密钥压测——会被 IP 失败限流 429。

Updated about 4 hours ago

Did this page help you?