常见问题
更新时间：2025.09.09●下单。在JSAPI支付、付款码支付、Native支付、APP支付、H5支付、小程序支付、代扣下单接口需要增加新的入参。
字段名 | 变量 | 必填 | 类型 | 示例 | 描述 |
|---|---|---|---|---|---|
是否需要分账 | profit_sharing | 否 | String(16) | Y | Y分账，N不分账，默认不分账,Y大写 |
●按金额分账。分账资金只能按金额传入，不支持按比例。分账总额不能超过订单金额减去手续费的净额。
●资金冻结期最长是30天，如果在30天内商户没有发起分账指令，则订单冻结资金将全部解冻，订单将处于完结状态，无法发起分账。
●属于分账方的资金，微信支付平台自动解冻给分账方。商户只需传入分给他方的账号和资金，订单剩余未分账的资金平台默认都属于分账方，平台在处理分账的同时，将直接解冻给分账方。
●分账接收方资金。分账接收方收到分账资金后，需要手动提现到银行账户。
●同一笔订单最多分账50次，每次可向50个接收方分账。
●由于接收方账户不可用导致的个别接收方分账失败，失败的分账资金，平台将直接转回给分账方。
●退款。未分账订单发起退款，资金将从冻结资金中直接出款退给用户，订单分账之后发生退款，在接收方同意分账回退的情况下，资金先可以从接收方（仅限商户类型）的账户中回退至分账方账户，再进行退款。
常见问题
Q：调用请求分账接口返回”非分账订单不支持分账“是什么原因？
A：请按照以下几点检查：
微信订单号填写错误，请检查确认
V2统一下单时未上传分账标识（profit_sharing=Y）的订单，是不支持分账的
Q：调用请求分账接口返回”分账金额不足“是什么原因？
A：请按照以下几点检查：
该订单已全额退款，没有资金可以分账
在微信支付中，实际收款之后微信支付会收取一定的结算手续费，在减去手续费后剩余的钱才能分账，详情可参考结算规则、费率、周期说明
该订单已解冻，已无分账资金（普通商户分账订单默认冻结期是30天）
超过订单剩余可分账金额或者该订单已无可分账金额，请检查确认（可调用查询订单待分账金额API确认剩余可分账金额）
Q：调用请求分账接口返回”分账接收方关系不存在，请检查参数中每个接收方的关系“是什么原因？
A：未添加分账接收方，分账接收方在分账之前需要调用“添加分账接收方接口”添加，请添加接收方后再调用请求分账接口。
Q：调用请求分账接口返回“分账金额超出最大分账比例”是什么原因？
A：请检查分账的金额是否超出在商户平台设置的允许分账的最大比例，设置路径如下：
普通直连商户设置分账比例路径：登陆商户平台-产品中心-分账-分账管理比例
Q：调用请求分账接口返回”无分账权限“是什么原因？
A：请按照以下几点排查：
1、未开通分账权限，请开通后再调用分账接口，可参考开通流程
2、请求参数错误
Q：分账调用“添加分账接收方接口”返回：微信用户姓名与实名不一致
A：请求中传了字段“个人姓名name”，该字段传了之后会校验用户实名是否正确，请填写正确的用户实名（查看用户实名认证路径：微信-我-服务-右上角三点-实名认证-姓名）
Q：分账接收方类型包括哪些？
A：有以下几个类型：
MERCHANT_ID：商户ID
PERSONAL_OPENID：个人openid（由父商户APPID转换得到）
PERSONAL_SUB_OPENID: 个人sub_openid（由子商户APPID转换得到）
Q：分账调用“请求分账接口”返回：订单处理中，请稍后重试
A：请按照以下几点检查：
请在订单支付成功1分钟后再调用分账接口
未结算的订单，请在结算后再调用分账接口请求分账。查看结算周期路径：超级管理员使用电脑登录商户平台，通过【账户中心】->【商户信息】->【结算信息】进行查看
商户开通了收支分离但手续费账户余额不足（手续费账户最低余额要求是100元以上，在充值手续费账户1小时后，订单会正常结算，即可正常调用分账接口）
Q：分账调用“请求分账接口”返回：分账接收方与原请求不一致
A：商户分账单号填写错误，调用“请求分账接口”多次分账，要生成新的“商户分账单号”，不能使用已经分过账的商户分账单号
Q：调用分账接口是否有额外的手续费
A：没有，商户的交易订单，平台会正常的收取结算手续费。商户使用分账功能没有额外的费用
Q：分账调用“请求添加分账接收方接口”返回：分账接收商户全称不匹配
A：请按照以下几点检查：
分账接收商户全称填写错误，请填写正确的商户全称，商户全称对应进件接口中的字段“商户名称merchant_name”
字段值没有加密，该字段值需要加密后上传，请正确加密后再提交。
上传的中文全称乱码，请检查接口编码是否正确，接口需要使用UTF-8编码
Q：分账调用“添加分账接收方接口”返回：账户不存在 ，请先点击充值
A：账户未开通，请接收方商户在商户平台点击“充值”创建账户（商户平台-交易中心-充值）
Q：分账如果有退款怎么处理，是否可以回退？
A：需注意以下几点：
已分出去的资金，在商户接收方同意的情况下，可以发起分账回退。（接收方可在“商户平台-交易中心-分账-分账接收设置”中开启同意分账回退）需要有接收分账成功记录才会有入口
分账退款逻辑
订单分账状态 | 申请退款金额 | 退款前提 | 退款出款账户 |
|---|---|---|---|
订单未分账 | 申请全额/部分退款 | 无，直接可退 | 商户冻结账户资金 |
订单部分分账 | 申请全额退款 | 1、需要先调“解冻剩余资金”接口，将订单剩余冻结资金全部解冻 | 商户可用余额 |
申请部分退款 | 当申请退款金额≤订单未分账冻结金额，直接可退 | 商户冻结账户资金 | |
1、当申请退款金额>订单未分账冻结金额，需要先调“解冻剩余资金”接口，将冻结资金全额解冻 | 商户可用余额 | ||
订单已完结分账 | 申请全额/部分退款 | 商户可用余额充足，直接可退 | 商户可用余额 |
|
Q：分账添加接收方接口，是在分账前添加一次，如果接收方无变化，后续是否还需要调用接口再添加
A：是的，如果接收方没有变化，只需要添加一次即可
Q：分账调用“查询分账结果接口”返回的分账单状态有几种
A：分账单状态：
PROCESSING—处理中
FINISHED—处理完成
分账接收方列表状态
PENDING：待分账
SUCCESS：分账成功
CLOSED：已关闭
Q：在商户平台设置了分账动账通知url，为什么收不到通知
A：请按照以下几点排查：
未设置动账通知url，该链接是通过商户平台【交易中心-分账接收设置】中配置的通知url，必须为https协议。如果链接无法访问，商户将无法接收到微信通知。必须为直接可访问的url，不能携带参数。
商户未设置加密的密钥，请登录商户平台操作！请参考APIv3密钥设置方法
只有分账接收方才能收到分账动账通知，分账方是不会有通知的，建议分账发起方，通过查询分账结果接口获取分账单最新的状态
Q：分账调用“请求分账接口”返回：对同笔订单分账频率过高
A：同笔订单多次分账频率是1秒1次，请降低频率后重试
Q：分账后资金到可提现是否有中间状态
A：没有中间状态
Q：分账后的资金什么时候可提现
A：分账后钱已经到商户的账户了，可以立刻提现
Q：分账调用“解冻剩余资金接口”的作用是什么
A: 调用该接口，可以将不需要进行分账的订单金额解冻给商户，解冻后的资金商户可自行发起提现
Q：分账调用“分账回退接口”返回：参数不正确，请检查参数
A：return_account与mch_id不能填写为相同的商户号，分账方与接收方商户号一致时，不需要回退
Q：分账订单调用“申请退款接口”返回：申请退款金额大于剩余未分账金额，请等待分账完成后再试
A：订单有过部分分账，退款金额不能大于剩余未分账金额，请调用“解冻剩余资金接口”解冻剩余资金后再发起退款
Q：查询分账结果接口里面分账单状态（status）字段，当值为FINISHED时是表示分账成功了吗
A：分账单FINISHED状态是表示分账动作执行完毕，并不代表分账是否成功。查看分账是否成功，需要调用查询分账结果接口，查看返回参数“分账接收方列表”里面的字段“分账结果result=SUCCESS”才是分账成功。
若分账结果 result=CLOSED 可以认为分账失败，可参考分账失败处理指引。
Q：调用“添加分账接收方接口”一次可以添加多个接收方吗
A：不可以，一次只能添加一个
Q：请求分账接口返回：分账接收方不允许为分账出资方
A：V2接口，“请求单次分账接口”分账接收方不允许为分账出资方，“请求多次分账接口”分账接收方可以为分账出资方
Q：调用“请求分账接口”，分账分给多个接收方，会出现分账既有成功又有失败的情况吗
A：同一次分账请求，会出现有的成功，有的失败的情况。具体请调用“查询分账结果接口”，查看返回参数“分账接收方列表”里面的字段“分账结果result=SUCCESS”才是分账成功。
Q：“请求分账接口”分账接收方列表中的参数description会体现在分账账单里面吗
A：在分账方分账账单和资金账单、分账接收方的资金账单里面都会体现
Q：调用“添加分账接收方接口”返回：请求正在处理中，请稍后重试
A：商户请求并发导致，重新再请求一次即可
Q：调用“添加分账接收方接口”返回：商户已添加的分账接收方个数过多。请先删除多余的分账接收方，并在24小时之后再尝试添加
A：添加分账接收方的个数限制是2W个，超过这个限制，请按照提示处理
Q：调用“请求分账回退接口”返回：可用余额不足，请充值后重新发起
A：“回退商户号”的账户可用余额不足，需充值后再原单重试才能回退成功。（充值指引：登陆商户平台【交易中心】->【资金管理】->【充值/转入】，根据指引充值即可）
Q：调用“请求分账回退接口”返回：可用余额不足，请充值后重新发起。这个时候，调用“查询分账回退结果API”却返回：PROCESSING（处理中），这个逻辑是正常的吗
A：是正常的，逻辑就是这样的。这种情况，商户可以按照提示要求，提醒“回退商户号”充值后再原单重试即可回退成功
Q：调用“请求分账回退接口”返回：PROCESSING（处理中），什么情况会返回这种状态
A：请参考以下几点：
网络抖动导致请求中断
商户账户资金转账频繁，导致回退在排队时超时
Q：调用“查询分账回退结果接口”返回：TIME_OUT_CLOSED
A：TIME_OUT_CLOSED是fail状态了，也就是处于最终态，是不需要重试的。状态是SUCCESS也同理，也是最终态，不需要重试。返回TIME_OUT_CLOSED时可更换一个回退单，重新分账回退一次即可
Q：一笔交易在分账完成之后，将接收方和分账账户的绑定关系解除（删除分账接收方），然后进行分账回退，会成功吗
A：会回退成功，不受删除分账关系的影响
这里的逻辑有两个：
这笔单曾经分给过了这个商户，且分账成功
这个商户开通了分账回退
Q：分账调用“分账回退接口”返回：PROCESSING
A：过一分钟后原单重试即可
Q：分账回退有时间限制吗
A：从订单创建的时间算起，现在分账回退限制180天以内的分账请求
Q：分账方添加接口，如果相同的分账方重复提交，会返回添加失败，还是覆盖之前的分账方信息
A：如果系统检测到已经绑定，那么会保留原来的数据，不更新数据，直接返回成功
Q：在商户平台-管理分账接收方中手动添加分账接收方报错：系统错误，请稍后再试
A：这个报错的原因是：账户未开通，请接收方商户在商户平台点击“充值”创建账户（商户平台-交易中心-充值）
Q：免充值和预充值的代金券，分账的时候，可分账的金额判断逻辑是一样的吗？比如10-5，使用了免充值代金券，可分账金额是5，使用了预充值代金券，可分账金额是10元还是5元呢
A：不一样，使用了免充值代金券，可分账金额是5，使用了预充值代金券，可分账金额是10
Q：请求分账接口返回：appid与openid不匹配
A：请求分账接口里面的APPID必须传绑定商户号的APPID，所以商户在添加分账接收方时获取的openid，也必须是这个商户号绑定的APPID获取的openid
Q：请求分账回退接口返回：分账指令不存在，请检查是否有对应的分账单
A：请按照以下几点排查：
分账回退里面的商户分账单号out_order_no，必须是请求分账接口的商户分账单号out_order_no
请先调用查询分账回退结果API确认分账是否成功，分账成功的分账单才能调用回退接口正常回退。
从订单创建的时间算起，分账回退限制180天以内的分账请求，超过180天不支持回退
Q：查询订单待分账金额返回：记录不存在
A：请按照以下几点排查：
记录不存在，可能是单号拼错了，请检查确认
订单未结算，请在订单结算后再查询
非分账订单，请检查订单支付时是否传了分账标识，传了分账标识的订单，才能正确查询
Q：商户号能正常完结分账，但是查询分账结果却提示“无分账权限”。是什么原因？
A：分账权限被冻结，请登陆商户平台查看站内信，按照指引申诉处理。
能正常完结分账的原因是：完结分账，就是将这笔订单的剩余的可分账的钱，都解冻给自己，由于这笔钱本来就是自己的，所以分账完结是一个安全的操作（钱没有给其他人，也没有给服务商，给了自己），所以是不会做权限校验的。当前要分出去给到别人时，就会做相关的权限校验了。
Q：请求分账接口，当提交请求后返回报错SYSTEM_ERROR，这个时候调用查询分账结果接口查询，每10分钟查询一次，共查询3次（共30分钟）。这样的情况下，是否可以不用原单重试？查询后是否可以换单再提交？
A：请求分账返回SYSTEM_ERROR时，调用查询分账结果接口3次（30分钟）后，查询结果仍然是不存在的情况：如果商户能保证在30分钟的窗口期内都不会重试，这样做是安全的。
但我们建议在返回SYSTEM_ERROR 情况下，商户还是原单重试，这种最安全，也不用查询和等待一个窗口期。
Q：一个微信支付单被全额退款，还可以继续分账吗？
A：不可以了，分账是针对该订单冻结的金额进行分账，如果退完款，就不能再分账了。
Q：比如一个订单支付金额是100.1元，假如手续费是0.1元。分账前先退款了30元，默认分账比例是30%，现在可以分账的金额还是30元，那就是说，可能出现100退了80，分出去30这种情况？
A：不会， 两个相加不会超过订单金额的， 也就是说退款没有超过70元的话，可分账金额是30，超过70，可分账金额是剩下的钱。
Q：直连分账，添加分账接收方这个APPID，如果商户号绑定了两个APPID“B”和"C"，需要分账的订单下单中传的APPID是B，这个时候，添加分账接收方中的这APPID可以是“C”吗？还是说必须是“B”？
A：请注意以下两点：
添加分账接收方的时候，B下的openid，C下的openid都可以
但是执行分账的时候，一次分账请求里，只能是同一个appid下的openid，不支持一次分账请求里的openid分别是俩appid下的
Q：查询分账结果接口返回：记录不存在
A：请按照以下几点排查：
记录不存在，可能是单号拼错了，请检查确认
订单未结算，请在订单结算后再查询
非分账订单，请检查订单支付时是否传了分账标识，传了分账标识的订单，才能正确查询
订单未分账，所以没有记录，请在订单分账后再查询
