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

>更新时间：2026.06.12

# 分账错误码



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

| 错误码 | 错误信息 |
| --- | --- |
| 268588428 | 分账单已完结（由商户主动发起） |
| 271644831 | 订单未结算，交易投诉冻结 |
| 271645722 | 无分账权限 |
| 271643176 | 剩余可分金额为 0 |
| 268588427 | 分账单已逾期解冻 |
| 271643179 | 分账单不属于当前查询的商户 |
| 268435464 | 参数超出取值范围 |
| 268435461 | 参数非法 |
| 271643175 | 不是分账订单 |
| 271644707 | 分账商户号与订单商户号不一致 |
| 268526884 | 超过分账回退最大周期 |
| 271644678 | 分账关系非法 |
| 271643151 | OPENID 与 APPID 不匹配 |
| 271644733 | appid 与 openid 不匹配 |
| 271644182 | 回退方没有开通分账回退功能 |
| 271644830 | 订单未结算，未到结算周期（被处罚） |
| 271643148 | 商户号不存在 |
| 268435463 | 参数过短 |
| 271644737 | 微信用户没有实名 |
| 271643173 | 超过分账限制的最大比例 |

* * *

## 二、错误码详细排查

### 268588428 — 分账单已完结（由商户主动发起）

排查步骤：

1. 同一笔订单一旦解冻剩余资金（ `unfreeze_unsplit=true`）即视为已完结，无法再次分账

2. 多次分账场景，只在最后一次分账才传 `unfreeze_unsplit=true`


* * *

### 271644831 — 订单未结算，交易投诉冻结

排查步骤：

1. 登录商户平台 → 交易中心 / 消费者投诉 2.0，查看该订单是否有未处理投诉

2. 按平台指引处理投诉后等待资金解冻，再发起分账


* * *

### 271645722 — 无分账权限

排查步骤：

1. 子商户登录商户平台 → 产品中心 → 「分账」，确认产品状态

2. 服务商场景下需要子商户先授权服务商使用「分账」产品


* * *

### 271643176 — 剩余可分金额为 0

排查步骤：

1. 调用「查询订单剩余待分金额」接口（ `GET /v3/profitsharing/transactions/{transaction_id}/amounts`）确认实际可分金额

2. 检查上一次分账是否已分完，或是否传了 `unfreeze_unsplit=true` 把剩余金额解冻了


* * *

### 268588427 — 分账单已逾期解冻

排查步骤：

1. 微信支付侧资金分账冻结期一般为 180 天，超过后剩余可分金额自动解冻

2. 超过冻结期的订单无法再发起分账，资金已结算回分出方


* * *

### 271643179 — 分账单不属于当前查询的商户

排查步骤：

1. 查询请求中的 `sub_mchid` 必须与创建该分账单（ `out_order_no`）时完全一致

2. 跨子商户不能互相查询分账单


* * *

### 268435464 — 参数超出取值范围

排查步骤：

1. `receivers` 数组长度不超过 50

2. `receivers.amount` 必须 \> 0，单位为分，不超过订单可分账金额

3. `receivers.description` 不超过 80 字符

4. 同一笔订单最多发起 50 次分账请求


* * *

### 268435461 — 参数非法

排查步骤：

1. `out_order_no` 取值范围 `[0-9a-zA-Z_\-|*@]`，长度 6-64 字符

2. `transaction_id` 是微信支付订单号

3. `receivers.type` 必须是枚举值： `MERCHANT_ID` / `PERSONAL_OPENID` / `PERSONAL_SUB_OPENID`

4. `receivers.name` 若传入需用微信支付公钥或平台证书加密，并在 Header 设置 `Wechatpay-Serial`

5. 检查是否有不可见字符（BOM / 全角空格）


* * *

### 271643175 — 不是分账订单

排查步骤：

1. 下单时必须在 `settle_info` 中设置 `profit_sharing=true`

2. 已支付订单的分账标识一般不能事后修改，建议默认设置开启


* * *

### 271644707 — 分账商户号与订单商户号不一致

排查步骤：

1. 分账 `sub_mchid` 必须等于支付订单的 `sub_mchid`

2. 跨子商户互相分账需把对方加为分账接收方


* * *

### 268526884 — 超过分账回退最大周期

排查步骤：

1. 分账回退时限一般为 180 天（自分账成功之日起），超期后无法通过 API 回退

2. 超期需要回退的资金，需与接收方线下协商处理


* * *

### 271644678 — 分账关系非法

排查步骤：

1. 先调用「添加分账接收方」接口（ `POST /v3/profitsharing/receivers/add`）建立分账关系

2. 商户接收方需在接收方商户平台「同意分账」

3. 个人接收方在添加时需通过用户授权


* * *

### 271643151 — OPENID 与 APPID 不匹配

排查步骤：

1. 接收方类型为 `PERSONAL_OPENID` 时， `receivers.account` 必须是该用户在请求 `appid` 下转换得到的 OpenID

2. OpenID 是 appid 维度的，不能跨 appid 使用

3. 请求体中需要传 `appid`


* * *

### 271644733 — appid 与 openid 不匹配

排查步骤：

1. 接收方类型为 `PERSONAL_SUB_OPENID` 时：

   - `receivers.account` 必须是该用户在 `sub_appid` 下转换得到的 sub\_openid

   - 请求体中必须传 `sub_appid` 字段
2. `sub_appid` 必须与 `sub_mchid` 有有效绑定关系


* * *

### 271644182 — 回退方没有开通分账回退功能

排查步骤：

1. 接收方商户登录商户平台 → 交易中心 → 分账 → 分账接收设置 → 开启「同意分账回退」

2. 仅 `MERCHANT_ID` 类型接收方支持回退；分给个人的资金不支持回退


* * *

### 271644830 — 订单未结算，未到结算周期（被处罚）

排查步骤：

1. 登录商户平台 → 账户中心 → 消息 / 违约记录，查看处罚类型与解除条件

2. 按指引申诉解除处罚后等待结算周期恢复正常


* * *

### 271643148 — 商户号不存在

排查步骤：

1. 核对 `sub_mchid` 与商户平台显示的商户号是否一致

2. 服务商管理后台确认商户进件状态为「正常」

3. 新进件商户等几分钟到几小时后重试


* * *

### 268435463 — 参数过短

排查步骤：

1. `out_order_no` ≥ 6 字符

2. `transaction_id` 长度固定为 32 字符

3. `receivers.account` 不能为空


* * *

### 271644737 — 微信用户没有实名

排查步骤：

1. 引导分账接收用户在微信内完成实名认证（钱包 → 实名认证）

2. 用户实名完成后业务侧可重新发起分账请求


* * *

### 271643173 — 超过分账限制的最大比例

排查步骤：

1. 登录商户平台 → 产品中心 → 授权的产品 → 分账授权，查看当前最大分账比例

2. 计算本次 `receivers.amount` 之和不超过：订单金额 × 最大分账比例

3. 如需提高比例可在「分账授权」页面申请