收藏
评论

【分账接口】常见问题官方

文档地址:「请求分账(直连)」「请求分账(服务商)」


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. 订单未分账,所以没有记录,请在订单分账后再查询


最后一次编辑于  2022-08-16
收藏

73 个评论

  • 方辉-【土味哥】专注农产品
    方辉-【土味哥】专注农产品
    2020-04-14

    要给企业分账,如何实现?

    2020-04-14
    赞同
    回复
  • peng
    peng
    2020-01-18

    分账调用“请求单次分账接口”返回:分账金额不足

    付款1分钱,在按比例分账也会出现

    2020-01-18
    赞同
    回复
  • LIKE
    LIKE
    2020-01-16

    Q:分账如果有退款怎么处理

    A:退款是只从发起帐号退的,分账号的钱如果已经分了,就不会退回,也就是退款的钱都由主发起帐号退

    --------------------------

    针对这种情况,只能由分账方自己负责,自负盈亏啊?或者自己直接干掉退款入口?

    2020-01-16
    赞同
    回复
  • F L
    F L
    2020-01-15

    RECEIVER_INVALID::商户号受限,不能成为接收方怎么处理阿?

    2020-01-15
    赞同
    回复
  • Newloncin
    Newloncin
    2019-12-20

    服务商邀请了特约商户授权了分账以后,特约商户在自己的商户号里开通分账功能吗?

    2019-12-20
    赞同
    回复
  • carrie🙂
    carrie🙂
    2019-12-10

    商户分账单号和商户订单号的区别


    2019-12-10
    赞同
    回复
  • Kelly.W
    Kelly.W
    2019-12-06

    同一个订单可以支持给同一个分账方多次分账吗?

    2019-12-06
    赞同
    回复
  • 高强
    高强
    2019-11-22

    发起邀请后,商户手机收到邀请通知,点开后提示“创建失败”是怎么回事?

    2019-11-22
    赞同
    回复
  • 2019-11-07

    冻结时不结算手续费,分帐时,分帐给企业帐号, 由接收方承担手续费,分帐给个人帐户,由分帐方承担手续费,这样可以吗


    2019-11-07
    赞同
    回复
  • Alex
    Alex
    2019-10-18



    2019-10-18
    赞同
    回复 4
    • Alex
      Alex
      2019-10-18
      一直提示剩余可回退的金额不足  很纳闷   分出去的金额就是347.3  但是回退的时候 回退34730却一直提示回退剩余可回退金额不足
      2019-10-18
      1
      回复
    • 盖伦会编程
      盖伦会编程
      2019-10-22
      是不是接收方账户把钱提走了
      2019-10-22
      回复
    • Alex
      Alex
      2019-10-22回复盖伦会编程
      接收方账户余额还有1万多  账户余额不足的这种情况,提示的错误信息就是账户可用余额不足
      2019-10-22
      1
      回复
    • Miracle
      Miracle
      2019-11-22
      兄弟 你的out_order_no是从哪里拿到的啊?
      2019-11-22
      回复

正在加载...

登录 后发表内容