文档地址：「请求分账（直连）」、「请求分账（服务商）」

Q1：调用请求分账接口返回”非分账订单不支持分账“是什么原因？

A1：请按照以下几点检查：

1. 微信订单号填写错误，请检查确认
2. 统一下单时未上传分账标识（profit_sharing=Y）的订单，是不支持分账的

Q2：调用请求分账接口返回”分账金额不足“是什么原因？

A2：请按照以下几点检查：

1. 该订单已全额退款，没有资金可以分账
2. 在微信支付中，实际收款之后微信支付会收取一定的结算手续费，在减去手续费后剩余的钱才能分账，详情可参考订单结算手续费说明
3. 该订单已解冻，已无分账资金（普通商户分账订单默认冻结期是30天; 电商分账订单默认冻结期是180天）
4. 超过订单剩余可分账金额或者该订单已无可分账金额，请检查确认（可调用查询订单待分账金额API确认剩余可分账金额）

Q3：调用请求分账接口返回”分账接收方关系不存在，请检查参数中每个接收方的关系“是什么原因？

A3：未添加分账接收方，分账接收方在分账之前需要调用“添加分账接收方接口”添加，请添加接收方后再调用请求分账接口。

Q4：调用请求分账接口返回“分账金额超出最大分账比例”是什么原因？

A4：请检查分账的金额是否超出在商户平台设置的允许分账的最大比例，设置路径如下：

1. 普通直连商户设置分账比例路径：登陆商户平台-产品中心-分账-分账管理比例
2. 普通服务商商户设置分账比例路径：需要特约商户可以登录商户平台-产品中心-授权的产品-分账授权中进行设置比例。
3. 电商收付通商户设置分账比例路径：登陆服务商商户平台-产品中心-我的工具箱-电商收付通-供应链分账设置里设置
4. 连锁品牌分账商户设置分账比例路径：登陆服务商平台-产品中心-合作工具箱-连锁品牌工具箱-品牌专区-品牌交易-品牌供应链分账-供应链分账管理设置

Q5：调用请求分账接口返回”无分账权限“是什么原因？

A5：请按照以下几点排查：

1、未开通分账权限，请开通后再调用分账接口，可参考开通指引

2、请求参数错误，服务商用了普通商户的开发文档提交参数，检查确认

服务商模式请求分账文档

普通商户分账文档

Q6：分账调用“添加分账接收方接口”返回：微信用户姓名与实名不一致

A6：请求中传了字段“个人姓名name”，该字段传了之后会校验用户实名是否正确，请填写正确的用户实名（查看用户实名认证路径：微信-我-服务-右上角三点-实名认证-姓名）

Q7：分账调用“请求单次分账接口”返回：分账接收方列表格式错误

A7：receivers中的参数amount类型错误，amount类型是int，请检查确认

Q8：分账接收方类型包括哪些？

A8：有以下几个类型：

• MERCHANT_ID：商户ID 
• PERSONAL_OPENID：个人openid（由父商户APPID转换得到）
• PERSONAL_SUB_OPENID: 个人sub_openid（由子商户APPID转换得到）

Q9：分账调用“请求单次分账接口”，为什么不返回分账结果

A9：分账是异步的，需要调用“查询分账结果”接口查询确认

Q10：分账调用“请求分账接口”返回：订单处理中，请稍后重试

A10：请按照以下几点检查：

1. 请在订单支付成功1分钟后再调用分账接口
2. 未结算的订单，请在结算后再调用分账接口请求分账。查看结算周期路径：超级管理员使用电脑登录商户平台（pay.weixin.qq.com），通过【账户中心】->【商户信息】->【结算信息】进行查看
3. 老资金流商户的订单，不支持分账（旧资金流流水介绍、新资金流流水介绍）
4. 商户开通了收支分离但手续费账户余额不足（手续费账户最低余额要求是100元以上，在充值手续费账户1小时后，订单会正常结算，即可正常调用分账接口）

Q11：分账调用“请求分账接口”返回：分账接收方与原请求不一致

A11：商户分账单号填写错误，调用“请求分账接口”多次分账，要生成新的“商户分账单号”，不能使用已经分过账的商户分账单号

Q12：分账调用“请求单次分账接口”

A12：请按照以下几点检查：

1. 签名类型错误，分账接口签名类型目前只支持HMAC-SHA256
2. 普通商户的分账订单，请使用普通商户分账接口，不能使用服务商分账接口
3. 系统超时，请使用原参数尝试再次掉调用API

Q13：调用分账接口是否有额外的手续费

A13：没有，商户的交易订单，平台会正常的收取结算手续费。商户使用分账功能没有额外的费用

Q14：分账调用“请求分账接口”返回：分账接收商户全称不匹配

A14：请按照以下几点检查：

1. 分账接收商户全称填写错误，请填写正确的商户全称，商户全称对应进件接口中的字段“商户名称merchant_name”
2. 字段值没有加密，该字段值需要加密后上传，请正确加密后再提交。
3. 上传的中文全称乱码，请检查接口编码是否正确，接口需要使用UTF-8编码

Q15：分账调用“添加分账接收方接口”返回：账户不存在 ，请先点击充值

A15：账户未开通，请接收方商户在商户平台点击“充值”创建账户（商户平台-交易中心-充值）

Q16：分账如果有退款怎么处理，是否可以回退？

A16：需注意以下几点：

已分出去的资金，在商户接收方同意的情况下，可以发起分账回退。（接收方可在“商户平台-交易中心-分账-分账接收设置”中开启同意分账回退）

更多分账订单退款逻辑，请查看文档说明

Q17：分账调用“请求单次分账接口”返回：签名错误

A17：请按照以下几点检查：

1. 使用签名检查工具校验签名算法是否有误
2. 确认秘钥是否有误（服务商模式使用服务商商户号秘钥，秘钥是在商户平台配置，如果同一商户号调用其它接口成功可排除是秘钥问题）
3. 确认接口实际的请求参数与生成签名原串的参数一致，不能增加或缺少参数（可通过打印签名原串进行排查）
4. 确认参数的大小写，参数名与接口文档一致
5. 签名原串的参数值使用原始值，不需要encode
6. 接口需要使用UTF-8编码

Q18：分账添加接收方接口，是在分账前添加一次，如果接收方无变化，后续是否还需要调用接口再添加

A18：是的，如果接收方没有变化，只需要添加一次即可

Q19：分账调用“查询分账结果接口”返回的分账单状态有几种

A19：有以下几点状态：

• ACCEPTED—受理成功 
• PROCESSING—处理中 
• FINISHED—处理完成 
• CLOSED—处理失败，已关单 

Q20：在商户平台设置了分账动账通知url，为什么收不到通知

A20：请按照以下几点排查：

1. 未设置动账通知url，该链接是通过商户平台【交易中心-分账接收设置】中配置的通知url，必须为https协议。如果链接无法访问，商户将无法接收到微信通知。必须为直接可访问的url，不能携带参数。示例：notify_url：https://pay.weixin.qq.com/wxpay/123456789
2. 商户未设置加密的密钥，请登录商户平台操作！请参考什么是APIv3密钥？如何设置？
3. 只有分账接收方才能收到分账动账通知，分账方是不会有通知的

Q21：分账调用“请求分账接口”返回：对同笔订单分账频率过高

A21：同笔订单多次分账频率是1秒1次，请降低频率后重试

Q22：分账后资金到可提现是否有中间状态

A22：没有中间状态

Q23：分账后的资金什么时候可提现

A23：分账后钱已经到商户的账户了，可以立刻提现

Q24：分账调用“完结分账接口”的作用是什么

A24: 调用该接口，可以将不需要进行分账的订单金额解冻给商户，解冻后的资金商户可自行发起提现

Q25：分账调用“分账回退接口”返回：参数不正确，请检查参数

A25：return_account与mch_id不能填写为相同的商户号，分账方与接收方商户号一致时，不需要回退

Q26：分账订单调用“申请退款接口”返回：申请退款金额大于剩余未分账金额，请等待分账完成后再试

A26：订单有过部分分账，退款金额不能大于剩余未分账金额，请调用“完结分账接口”解冻剩余资金后再发起退款

Q27：查询分账结果接口里面分账单状态（status）字段，当值为ACCEPTED时是表示分账成功了吗

A27：分账单的状态是表示分账单是否受理成功，并不代表分账是否成功。查看分账是否成功，需要调用查询分账结果接口，查看返回参数“分账接收方列表”里面的字段“分账结果result=SUCCESS”才是分账成功。

Q28：调用“添加分账接收方接口”一次可以添加多个接收方吗

A28：不可以，一次只能添加一个

Q29：请求分账接口返回：分账接收方不允许为分账出资方

A29：请按照以下几点检查：

1. V2接口，“请求单次分账接口”分账接收方不允许为分账出资方，“请求多次分账接口”分账接收方可以为分账出资方
2. V3接口，finish为true的情况，“请求分账接口”分账接收方不允许为分账出资方（这种场景，直接调完结分账API就好）。finish为false的情况，“请求分账接口”分账接收方可以为分账出资方

Q30：调用“请求分账接口”，分账分给多个接收方，会出现分账既有成功又有失败的情况吗

A30：同一次分账请求，会出现有的成功，有的失败的情况。具体请调用“查询分账结果接口”，查看返回参数“分账接收方列表”里面的字段“分账结果result=SUCCESS”才是分账成功。

Q31：“请求分账接口”分账接收方列表中的参数description会体现在分账账单里面吗

A31：在分账方分账账单和资金账单、分账接收方的资金账单里面都会体现

Q32：分账调用“添加分账接收方接口”返回：请求正在处理中，请稍后重试

A32：商户请求并发导致，重新再请求一次即可

Q33：分账调用“添加分账接收方接口”返回：商户已添加的分账接收方个数过多。请先删除多余的分账接收方，并在24小时之后再尝试添加

A33：添加分账接收方的个数限制是2W个，超过这个限制，请按照提示处理

Q34：电商收付通分账调用“请求分账回退接口”返回：可用余额不足，请充值后重新发起

A34：“回退商户号”的账户可用余额不足，需充值后再原单重试才能回退成功。（充值指引：登陆商户平台【交易中心】->【资金管理】->【充值/转入】，根据指引充值即可）

Q35：电商收付通分账调用“请求分账回退接口”返回：可用余额不足，请充值后重新发起。这个时候，调用“查询分账回退结果API”却返回：PROCESSING（处理中），这个逻辑是正常的吗

A35：是正常的，逻辑就是这样的。这种情况，商户可以按照提示要求，提醒“回退商户号”充值后再原单重试即可回退成功

Q36：电商收付通分账调用“请求分账回退接口”返回：PROCESSING（处理中），什么情况会返回这种状态

A36：请参考以下几点：

1. 网络抖动导致请求中断
2. 商户账户资金转账频繁，导致回退在排队时超时

Q37：电商收付通分账调用“查询分账回退结果接口”返回：TIME_OUT_CLOSED

A37：TIME_OUT_CLOSED是fail状态了，也就是处于最终态，是不需要重试的。状态是SUCCESS也同理，也是最终态，不需要重试。返回TIME_OUT_CLOSED时可更换一个回退单，重新分账回退一次即可

Q38：电商收付通分账调用“请求分账接口”返回：分账补贴还未到账，不能受理分账

A38：报这个错误，是因为支付的订单在统一下单里面传了参数“补差金额：subsidy_amount”，传这个参数后，需要调用“请求补差API”完成补差，然后再调用“请求分账接口”即可正常分账

Q39：一笔交易在分账完成之后，将接收方和分账账户的绑定关系解除（删除分账接收方），然后进行分账回退，会成功吗

A39：会回退成功，不受删除分账关系的影响

这里的逻辑有两个：

1. 这笔单曾经分给过了这个商户，且分账成功
2. 这个商户开通了分账回退

Q40：分账调用“分账回退接口”返回：PROCESSING

A40：过一分钟后原单重试即可

Q41：分账回退有时间限制吗

A41：从订单创建的时间算起，现在分账回退限制180天以内的分账请求

Q42：分账方添加接口，如果相同的分账方重复提交，会返回添加失败，还是覆盖之前的分账方信息

A42：如果系统检测到已经绑定，那么会保留原来的数据，不更新数据，直接返回成功

Q43：在商户平台-管理分账接收方中手动添加分账接收方报错：系统错误，请稍后再试

A43：这个报错的原因是：账户未开通，请接收方商户在商户平台点击“充值”创建账户（商户平台-交易中心-充值）

Q44：免充值和预充值的代金券，分账的时候，可分账的金额判断逻辑是一样的吗？比如10-5，使用了免充值代金券，可分账金额是5，使用了预充值代金券，可分账金额是10元还是5元呢

A44：不一样，使用了免充值代金券，可分账金额是5，使用了预充值代金券，可分账金额是10

Q45：电商收付通请求分账接口返回：appid与openid不匹配

A45：请求分账接口里面的APPID必须传电商平台服务商的APPID，所以商户在添加分账接收方时获取的openid，也必须是这个电商平台服务商APPID获取的openid

Q46：请求分账回退接口返回：分账指令不存在，请检查是否有对应的分账单

A46：请按照以下几点排查：

1. 分账回退里面的商户分账单号out_order_no，必须是请求分账接口的商户分账单号out_order_no
2. 请先调用查询分账回退结果API确认分账是否成功，分账成功的分账单才能调用回退接口正常回退。
3. 从订单创建的时间算起，分账回退限制180天以内的分账请求，超过180天不支持回退

Q47：查询订单待分账金额返回：记录不存在

A47：请按照以下几点排查：

1. 记录不存在，可能是单号拼错了，请检查确认
2. 订单未结算，请在订单结算后再查询
3. 非分账订单，请检查订单支付时是否传了分账标识，传了分账标识的订单，才能正确查询

Q48：商户号能正常完结分账，但是查询分账结果却提示“无分账权限”。是什么原因？

A48：分账权限被冻结，请登陆商户平台查看站内信，按照指引申诉处理。

能正常完结分账的原因是：完结分账，就是将这笔订单的剩余的可分账的钱，都解冻给自己，由于这笔钱本来就是自己的，所以分账完结是一个安全的操作（钱没有给其他人，也没有给服务商，给了自己），所以是不会做权限校验的。当前要分出去给到别人时，就会做相关的权限校验了。

Q49：请求分账接口，当提交请求后返回报错SYSTEM_ERROR，这个时候调用查询分账结果接口查询，每10分钟查询一次，共查询3次（共30分钟）。这样的情况下，是否可以不用原单重试？查询后是否可以换单再提交？

A19：请求分账返回SYSTEM_ERROR时，调用查询分账结果接口3次（30分钟）后，查询结果仍然是不存在的情况：如果商户能保证在30分钟的窗口期内都不会重试，这样做是安全的。

但我们建议在返回SYSTEM_ERROR 情况下，商户还是原单重试，这种最安全，也不用查询和等待一个窗口期。

Q50：一个微信支付单被退完款，还可以继续分账吗？

A50：不可以了，分账是针对该订单冻结的金额进行分账，如果退完款，就不能再分账了。

Q51：比如一个订单支付金额是100.1元，假如手续费是0.1元。分账前先退款了30元，默认分账比例是30%，现在可以分账的金额还是30元，这样理解没有问题吧？

A51：没有问题

Q52：比如一个订单支付金额是100.1元，假如手续费是0.1元。分账前先退款了30元，默认分账比例是30%，现在可以分账的金额还是30元，那就是说，可能出现100退了80，分出去30这种情况？

A52：不会， 两个相加不会超过订单金额的， 也就是说退款没有超过70元的话，可分账金额是30，超过70，可分账金额是剩下的钱。

Q53：普通服务商分账，添加分账接收方这个APPID，如果服务商商户号绑定了两个APPID“B”和"C"，需要分账的订单统一下单中传的APPID是B，这个时候，添加分账接收方中的这APPID可以是“C”吗？还是说必须是“B”？

A53：请注意以下两点：

1. 添加分账接收方的时候，B下的openid，C下的openid都可以
2. 但是执行分账的时候，一次分账请求里，只能是同一个appid下的openid，不支持一次分账请求里的openid分别是俩appid下的

Q54：查询分账结果接口返回：记录不存在

A54：请按照以下几点排查：

1. 记录不存在，可能是单号拼错了，请检查确认
2. 订单未结算，请在订单结算后再查询
3. 非分账订单，请检查订单支付时是否传了分账标识，传了分账标识的订单，才能正确查询
4. 订单未分账，所以没有记录，请在订单分账后再查询