小程序支付错误码

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

二、错误码详细排查

268512771 — 订单不存在

排查步骤：

1. 检查 out_trade_no / transaction_id 是否与下单时完全一致

2. 检查查询用的商户号是否与下单时一致（服务商场景注意 sub_mchid）

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

268447840 — 请求频率超过限制

排查步骤：

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

2. 业务量确实较大可联系微信支付运营申请提频

268435461 — 参数非法

排查步骤：

1. 检查金额字段单位是否为分（非元）

2. 检查时间格式是否为 RFC 3339（如 2025-08-01T00:00:00+08:00）

3. 检查必填字段、枚举值是否符合接口文档

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

268449538 / 268498689 — 订单已支付

排查步骤：

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

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

270924358 — 参数中含有非法的额外参数

排查步骤：

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

2. 注意 V2 与 V3 参数结构不同，不要混用

268443715 — 商户状态为不可用或已注销

排查步骤：

1. 登录商户平台确认商户号当前状态

2. 如被处罚或冻结，按指引申诉处理

268447843 — 商户号和订单不匹配

排查步骤：

1. 检查请求所用 mchid 是否与下单时一致

268443705 — 子商户 mchid 不能与自身 mchid 相同（服务商）

排查步骤：

1. sub_mchid 必须传子商户的商户号，不能等于服务商商户号 sp_mchid

268447914 — 该订单已失效

排查步骤：

1. 该订单已被关闭或 prepay_id 已过期，请使用新的 out_trade_no 重新下单

268443704 — 受理机构必须传入 sub_mch_id（服务商）

排查步骤：

1. 服务商模式下下单 / 查单 / 关单接口必须携带 sub_mchid

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

排查步骤：

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

2. 按指引申诉处理

268449641 — 当前交易不允许进行普通关单（只能撤销）

排查步骤：

1. 付款码支付场景不支持关单，请改用撤销接口（reverse）

268447845 — 子商户号和订单信息不匹配（服务商）

排查步骤：

1. 检查请求中的 sub_mchid 是否与下单时一致

268443699 — 签名错误

排查步骤：

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

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

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

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

5. 建议使用官方 SDK 自动签名

268501013 — 小程序支付必须传 openid

排查步骤：

1. 小程序下单必须传 payer.openid

2. 通过 wx.login + auth.code2Session 获取用户 openid

3. 确保获取 openid 使用的 appid 与下单的 appid 一致

268443701 — 受理关系不存在（服务商）

排查步骤：

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

2. 子商户在商户平台 → 我的授权产品中授权

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

268498688 — 请求重入时参数与首次不一致

排查步骤：

1. 同一 out_trade_no 重试时所有参数必须与首次一致

2. 如需修改参数，先关单后用新的 out_trade_no 下单

268445527 — appid 和 mch_id 不匹配

排查步骤：

1. 登录商户平台确认 appid 是否已与商户号绑定

2. 服务商场景下 sp_appid 也需与 sp_mchid 绑定

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

268435464 — 参数超出取值范围

排查步骤：

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

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

3. 对照接口文档逐字段核对