接入易错点

更新时间:2026.10.30
||| 安装 Skill

一、分账金额与可分账上限

注意事项

说明、正确应该怎么做

不做会怎么样

 分账金额须按净额、比例及累计金额校验

 说明:分账请求按金额传入,不支持直接按比例请求;同一订单历次分给全部接收方的金额合计,不得超过扣费后的订单净额与当前已配置最高分账比例所对应的上限,默认最高比例为30%,退款会降低剩余可分金额。
正确应该怎么做:① 接入前确认商户模式、实际结算方式和当前配置的最高分账比例;② 查询退款状态、订单净额及剩余待分金额,计算“净额上限”和“比例上限”,以二者较小值作为累计可分账上限;③ 统计同一订单已成功及处理中的分账金额,再按分为单位计算各接收方 receivers.amount;④ 发生退款或补差回退后重新计算累计上限;⑤ 业务确需超过默认比例时,先完成高比例申请及授权配置。
典型反例:只校验本次请求金额,未累计同一订单历次分账;退款后仍按原支付金额计算比例。
见 4012067962-普通商户分账产品介绍、4014547102-普通商户分账常见问题、4020807103-普通商户分账错误码、4012072582-服务商分账产品介绍、4014547107-服务商分账常见问题、4020807198-服务商分账错误码、4012086891-平台收付通产品介绍、4012525463-平台收付通分账常见问题、4012691594-平台收付通请求分账、4012477751-查询订单剩余待分金额 

 请求分账返回 INVALID_REQUEST 或 RULE_LIMIT,提示「分账金额超出最大分账比例」,或提示「分账金额不足」;超出部分无法分出,佣金或分润结算无法完成。 

二、分账账期与发起时机

注意事项

说明、正确应该怎么做

不做会怎么样

 需分账的订单须在冻结期内发起分账

 说明:需要分账的订单在支付成功后进入资金冻结状态;直连商户和普通服务商默认冻结30天,平台收付通默认冻结180天,解冻后不再支持分账。
正确应该怎么做:① 接入前按实际商户模式确定冻结期限;② 在支付成功并完成结算后及时创建分账任务,并在到期前完成请求;③ 账期更长时在到期前按《分账默认冻结期延长指引》申请;④ 确定不再分账时主动调用解冻剩余资金接口。
典型反例:未区分普通分账与平台收付通,将全部业务统一按30天安排账期。
见 4014547102-普通商户分账常见问题、4012072582-服务商分账产品介绍、4012525463-平台收付通分账常见问题、4012086891-平台收付通产品介绍、 https://docs.qq.com/doc/DQUt1UnZudVhzSWZx  

 冻结到期后待分账资金自动解冻,之后请求分账会因订单已解冻或剩余可分金额不足而失败,账期管理、佣金或分润结算无法完成。

三、退款前的分账回退与回退单重试

注意事项

说明、正确应该怎么做

不做会怎么样

 回退单超时关闭后须更换单号重试

 说明:TIME_OUT_CLOSED 表示分账回退单已超时关闭,属于失败终态,不能在同一回退单上继续重试。
正确应该怎么做:① 查询回退结果,区分 PROCESSING、SUCCESS 与 FAILED;② PROCESSING 期间沿用原 out_return_no 查询;③ 返回 TIME_OUT_CLOSED 后生成新的 out_return_no,按原分账单、原接收方及未完成金额重新发起;④ 再次查询新回退单直至终态。处理中回退单5天未成功会被置为失败。
典型反例:看到 TIME_OUT_CLOSED 后反复使用原回退单号重试,或把处理中状态误认为可直接换单重发。
见 4012525287-请求分账回退、4014547102-普通商户分账常见问题、4012466854-服务商请求分账回退、4014547107-服务商分账常见问题 

 回退结果保持 FAILED,失败原因为 TIME_OUT_CLOSED,已分账资金无法回到分账方,后续退款或资金归集被阻塞。 

四、不分账订单退款的出款账户

注意事项

说明、正确应该怎么做

不做会怎么样

 指定不分账订单退款须使用可用余额

 说明:下单时指定不分账的订单,支付完成并过结算周期后,资金转入可用余额,该过程不涉及分账;退款若要指定出款账户,应与当前实际资金账户一致。
正确应该怎么做:① 保存下单时的分账标识及订单当前资金状态;② 指定不分账订单结算后,退款从 AVAILABLE 可用余额出款,不再指定 UNAVAILABLE;③ 退款前校验指定账户及金额满足退款接口要求;④ 若退款受理后余额不足,及时补足资金,避免重试超期关闭。
典型反例:下单时传不分账,资金解冻到可用余额后,退款仍通过 amount.from 指定 UNAVAILABLE 出款。
见 4013071200-订单退款常见问题、4013071036-申请退款、4013071031-订单退款开发指引、4014547102-普通商户分账常见问题 

 退款单状态变为 CLOSED,用户未收到退款;若受理后资金连续不足,超过7天重试仍未达到退款金额也会关闭。 

五、分账接收方关系的建立与删除

注意事项

说明、正确应该怎么做

不做会怎么样

 服务商号作为接收方时资金须进入基本账户

 说明:平台收付通平台商户可被默认添加为分账接收方,服务商号接收的佣金等分账资金进入服务商商户号基本账户;其他接收方需先通过添加分账接收方接口建立关系。
正确应该怎么做:① 确认接收账号是平台服务商商户号;② 核对平台维度是否已有接收方关系,缺失时调用添加分账接收方接口;③ 请求分账时填写对应 MERCHANT_ID 与商户号;④ 通过查询分账结果确认资金到账结果。
见 4012086891-平台收付通产品介绍、4012477758-添加分账接收方、4012087888-平台收付通分账开发指引 

 原代收账户停用后没有有效接收方关系时,利润分账无处承接,平台佣金无法到账。