---
url: "https://pay.weixin.qq.com/doc/v3/partner/4020807195.md"
title: "错误码"
doc_id: 4020807195
---

>更新时间：2026.06.12

# 订单退款错误码



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

| 错误码 | 错误信息 |
| --- | --- |
| 268558930 | 退款 API 错误码限流 |
| 268875782 | 查询退款单不存在 |
| 269546507 | 商户证书序列号有误 |
| 268892177 | 订单已全额退款 |
| 268892193 | 受理机构发起退款时，必须传入子商户 mchid |
| 268892180 | 订单不存在 |
| 268892205 | 申请退款金额大于剩余未分账金额，请等待分账完成后再试 |
| 268892709 | 基本账户余额不足，请充值后重新发起 |
| 268892184 | 当前订单过期不能申请退款 |
| 268449311 | 申请退款金额超过订单可退金额 |
| 268435464 | 参数超出取值范围 |
| 268892182 | 不允许操作其他人的订单 |
| 268892183 | 订单或退款金额不一致 |
| 268448746 | 单笔订单退款频率限制 |
| 270924358 | 参数中含有非法的额外参数 |
| 268892195 | 退款单状态错误 |
| 268892181 | 订单已关闭 |
| 268875776 | 商户参数错误 |
| 268435461 | 参数非法 |
| 268435463 | 参数过短 |

* * *

## 二、错误码详细排查

### 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 字符）