订单退款错误码

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

二、错误码详细排查

268558930 — 退款 API 错误码限流

排查步骤：

1. 降低退款发起频率，使用指数退避重试

2. 同一订单的退款请求需串行化处理

268875782 — 查询退款单不存在

排查步骤：

1. 检查 out_refund_no 是否与发起退款时一致

2. 若退款刚发起，等几秒后重试；也可用相同参数重新发起退款（接口幂等）

269546507 — 商户证书序列号有误

排查步骤：

1. 登录商户平台 → 账户中心 → API 安全 → API 证书管理，确认当前生效证书序列号

2. 核对 Authorization 头中的 serial_no 与签名所用私钥是同一对证书

3. 服务商场景下使用的是服务商商户号的证书

268892177 — 订单已全额退款

排查步骤：

1. 该订单可退金额已退完，不能再退；请勿换 out_refund_no 重试

268892193 — 受理机构发起退款时，必须传入子商户 mchid

排查步骤：

1. 服务商发起退款必须携带 sub_mchid，且与原订单一致

2. 直连商户不应传 sub_mchid

268892180 — 订单不存在

排查步骤：

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

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

268892205 — 申请退款金额大于剩余未分账金额

排查步骤：

1. 等待分账完成后再退款

2. 或先调用分账回退接口拉回已分账金额后再发起退款

268892709 — 基本账户余额不足，请充值后重新发起

排查步骤：

1. 登录商户平台 → 资金管理 → 账户资金，查看「基本账户」余额

2. 充值到账后重新发起退款

3. 服务商场景下注意是从子商户的基本户扣款

268892184 — 当前订单过期不能申请退款

排查步骤：

1. 原订单已超过退款时效，无法通过 API 退款

2. 如有特殊情况请联系微信支付客服处理

268449311 — 申请退款金额超过订单可退金额

排查步骤：

1. 本次 refund.amount 不能超过订单剩余可退金额（订单总额 - 累计已退）

2. 金额单位为分

268435464 — 参数超出取值范围

排查步骤：

1. 对照接口文档检查字段取值范围（金额、字符串长度、枚举值等）

268892182 — 不允许操作其他人的订单

排查步骤：

1. 退款请求的商户号必须与原订单归属一致

2. 服务商场景下 sub_mchid 必须与原订单一致

268892183 — 订单或退款金额不一致

排查步骤：

1. amount.total 必须等于原订单实际支付金额（分）

2. 同一 out_refund_no 重试时所有金额字段必须与首次完全相同

3. 不要把 refund（本次退款金额）与 total（订单原始金额）搞反

268448746 — 单笔订单退款频率限制

排查步骤：

1. 同一订单的退款 / 查询请求需串行化处理

2. 使用指数退避策略重试

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

排查步骤：

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

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

268892195 — 退款单状态错误

排查步骤：

1. 当前操作与退款单状态不兼容，请先查询退款单状态后按状态处理

268892181 — 订单已关闭

排查步骤：

1. 已关闭的订单本身未支付，无需也不能退款

268875776 — 商户参数错误

排查步骤：

1. 检查 mchid / sub_mchid 格式及商户号状态

2. 服务商场景下确认子商户已授权当前支付产品

3. 新进件商户号需等几分钟到几小时生效

268435461 — 参数非法

排查步骤：

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

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

3. 检查 notify_url 是否为 HTTPS、可公网访问

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

268435463 — 参数过短

排查步骤：

1. 对照接口文档检查字段最小长度（如 out_refund_no ≥ 6 字符）