错误码说明

业务错误码（rtn_code）

错误码	说明
0000	请求成功
SIGN_ERROR	签名验证失败，检查签名算法和 SecretId
PAY_APIKEY_MERCHANT_ERROR	商户信息验证失败，检查 apiKey 和 merchantId

系统错误码

错误码	说明
4001	缺少 X-Signature 请求头
4002	缺少 X-Timestamp 请求头
4003	缺少 X-Nonce 请求头
4004	缺少 X-Api-Key 请求头
4005	无效的 API Key
4006	签名验证失败
4007	请求已过期（时间戳超出范围）
4008	请求重复（Nonce 已使用）

常见错误排查

SIGN_ERROR（签名错误）

• 检查参与签名的字段类型（Integer/BigDecimal 不参与）
• 检查字段排序是否按 ASCII 字典序
• 检查 SecretId 是否正确追加到末尾
• 检查 SHA-256 输出是否为小写十六进制

PAY_APIKEY_MERCHANT_ERROR

• 检查 URL 路径中的 apiKey 是否正确
• 检查请求体中的 merchantId 是否与 apiKey 匹配