分账错误码

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

二、错误码详细排查

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. 如需提高比例可在「分账授权」页面申请