错误处理

Open API HTTP 状态码通常为 200，业务是否成功以响应 JSON 的 code 判断。

通用响应结构

{
  "code": 0,
  "msg": "成功",
  "data": {}
}

字段	说明
code	业务码，0 表示成功。
msg	错误或成功信息。
data	业务数据。Open POST 成功时通常是加密信封。

常见错误

code	msg 示例	说明
11015	Open API 请求体必须是加密信封	POST 未发送 encrypted_key 和 biz_content。
-1	交易订单不存在	查询条件未命中订单，或订单不属于当前商户。
-1	Open API 签名请求头不能为空	缺少签名请求头。

接入时建议按以下策略处理：

• code == 0：成功，继续解密或读取业务 data。
• code != 0：失败，记录 code、msg、X-Request-Id、请求路径和商户订单号。
• 签名、加密、凭证类错误不应自动重试，应先修正配置或代码。
• 网络超时或 HTTP 5xx 可以有限重试，重试时必须使用新的 X-Nonce 和 X-Timestamp。

幂等建议

• 创建收款、退款、提现 / 代付时，商户侧 merchant_order_no 应全局唯一。
• 如果请求超时，优先使用查单接口确认订单状态，不要直接换单号重下。
• 通知处理以 trade_no 或 merchant_order_no + trade_type 做幂等键。