JSAPI合单支付错误码

一、错误码速查表（TOP 20）

二、错误码详细排查

268435461 — 参数非法

排查步骤：

1. 检查金额字段单位是否为分（非元），且各子单金额之和等于合单总金额

2. 检查时间格式是否为 RFC 3339

3. 检查必填字段：combine_appid / combine_mchid / combine_out_trade_no / sub_orders 等

4. 检查是否有不可见字符（如全角空格、BOM 头）

270328344 — 订单不存在

排查步骤：

1. 检查 combine_out_trade_no 是否与下单时一致

2. 检查查询用的商户号是否与下单时一致

3. 若下单刚发起，等几秒后重试

270333442 — 输入的请求非法，请求关单的子单数与下单子单数不一致

排查步骤：

1. 关单 / 查单时 sub_orders 数量必须与下单时一致

2. 建议下单后持久化合单结构，后续操作时直接组装

268445527 — 商户和 appid 不存在有效绑定关系

排查步骤：

1. 登录商户平台绑定 combine_appid 与 combine_mchid

2. 服务商场景下 combine_appid 也需与服务商商户号绑定

3. 绑定后需等几分钟生效

268448010 — 此商家的收款功能已被限制

排查步骤：

1. 登录商户平台 → 账户中心 → 消息 / 违约记录查看具体处罚

2. 按指引申诉处理

270333444 — 入参子单子商户 id 不匹配

排查步骤：

1. 检查每个子单的 sub_mchid 是否与合单下单时一致

270333952 — 入参错误

排查步骤：

1. 对照接口文档检查参数，特别注意 sub_orders 等嵌套结构字段

2. 移除请求体中接口文档未定义的字段

270332422 — 订单已支付

排查步骤：

1. 同一 combine_out_trade_no 已支付成功，不要重复下单，也不要对其调用关单接口

2. 如需取消请走退款流程

270333959 — 商户订单号重复

排查步骤：

1. combine_out_trade_no 与子单 out_trade_no 必须全局唯一，不要复用历史单号

2. 同一笔订单的幂等重试需保持参数与首次一致

270330947 — 订单状态错误

排查步骤：

1. 当前操作与订单状态不兼容，请先查询订单状态后按状态发起对应操作

270328888 — 当前订单已关闭，请重新下单

排查步骤：

1. 该合单订单已关闭，使用新的 combine_out_trade_no 和子单 out_trade_no 重新下单

270328886 — 下单时子单有重复

排查步骤：

1. sub_orders 数组内每个子单的 out_trade_no + sub_mchid 组合不能重复

2. 拼装前先做去重

268441788 — 子商户未授权父商户的产品权限

排查步骤：

1. 服务商平台 → 产品中心 → 特约商户授权产品，发起合单支付邀请

2. 子商户在商户平台授权

3. 授权后需等几分钟生效

268435464 — 参数超出取值范围

排查步骤：

1. 检查合单金额、子单金额（单位为分）是否在允许范围

2. 检查 sub_orders 长度是否符合接口文档限制

3. 检查字符串字段是否超出最大长度

270329361 — 请求过于频繁，请稍后重试

排查步骤：

1. 降低请求频率，使用指数退避重试

2. 同一 combine_out_trade_no 的处理需串行化

270328882 — 输入的请求非法，请求关单的子单信息与下单时的子单信息不一致

排查步骤：

1. 关单 / 查单时 sub_orders 内每个子单的 sub_mchid + out_trade_no 必须与下单时一致

2. 建议下单后持久化子单清单，后续操作直接读取

268437833 — 签名错误

排查步骤：

1. 检查 Authorization 头格式是否符合规范

2. 确认 serial_no 与签名所用私钥配对

3. 检查签名串拼接：换行符、URL 路径、body 为空时末尾仍要 \n

4. 确认服务器时间偏差不超过 5 分钟

5. 同时确认 combine_mchid / sub_mchid 真实存在且状态正常

6. 建议使用官方 SDK

270332417 — 当前请求人数较多，请稍后再试

排查步骤：

1. 带指数退避重试 1-2 次

2. 同一 combine_out_trade_no 的处理需串行化

268435462 — 参数过长

排查步骤：

1. 对照接口文档检查字段最大长度（如 combine_out_trade_no ≤ 32 字符）

270333962 — 商户订单号重复

排查步骤：

1. combine_out_trade_no 与历史订单冲突，请使用新单号

2. 如确为幂等重试，参数必须与首次完全一致