编程 回退单 SUCCESS 不等于用户收到退款:分账回退日终对账的三处状态错位

2026-11-19 00:04:55

回退单 SUCCESS 不等于用户收到退款:分账回退日终对账的三处状态错位

区别于 #8651 的字段方向与状态机,本文不重复 sub_mchid、out_return_no、result 等参数语义,只讨论日终对账时回退单、退款单、分账单三者状态对不上形成的账实差异,以及核对口径。

一、结论

回退单 SUCCESS ≠ 退款成功 ≠ 用户拿到钱。

分账回退和退款是两条独立链路。文档写明:分账订单的退款与分账回退无强耦合,是否需要回退由平台决定;二级商户余额充足时可以不发起回退直接退款;回退也可以先于退款请求,或后于退款请求。两条链路各自有终态,组合后至少四种结果,其中两种是错位。

错位一:回退先成功,退款后失败

回退单 SUCCESS 只说明钱从分账接收方回到了分账方账户。退款走另一条链路,金额从可提现金额账户出。按退款规则,订单已完结分账时,全额退款与部分退款都要求可提现金额余额充足;订单标记为需要分账时,全额退款需先完成分账,把剩余冻结资金从待结算金额解冻至可提现金额,且可提现金额余额 ≥ 退款金额。回退到账不等于可提现金额已足额,也不等于退款单一定能走完。

结果:接收方的钱回来了,用户没收到退款,平台账上多出这笔资金。对账表现为回退单 SUCCESS、退款单失败或 ABNORMAL、退款成功金额小于应退金额。

错位二:退款先成功,回退后失败

这条更隐蔽,因为退款单已是终态成功,业务侧默认闭环。文档允许先退款后回退,此时回退单可能还在 PROCESSING。PROCESSING 是非终态,5 天未成功会被置为 FAILED,fail_reason=TIME_OUT_CLOSED;也可能直接以 BALANCE_NOT_ENOUGH 失败。

结果:用户已经拿到退款,钱没从分账接收方拿回,平台垫付。对账表现为退款成功金额已计入,对应回退单终态 FAILED 或仍 PROCESSING,应收未回退余额为正。

错位三:回退单 FAILED,商户侧按 SUCCESS 记账

两类来源:同步应答只看 HTTP 200,没读 result;或 result=PROCESSING 时没有后续查询、没有同号重发确认,把中间态当终态入账。查询接口是 GET /v3/ecommerce/profitsharing/returnorders(电商/服务商),普通商户用 GET /v3/profitsharing/return-orders,sub_mchid + out_return_no 必填,应答里的 result 才是回退终态。

结果:本地账上记了一笔已回退,微信侧实际 FAILED,账实不符,通常要等下一轮对账或人工排查才暴露。

二、404 不能用来判断「单号填错」

查询回退结果查不到时返回 404 RESOURCE_NOT_EXISTS。这个返回只能说明「按这个键查不到单」,无法区分两种情况:out_return_no 填错或键不一致;回退单根本没建成功(请求失败、参数校验未过、前置条件不满足)。

判据必须回查本地:

  1. 本地 out_return_no 是否落库,落库值与请求体是否一致;
  2. 微信 return_no 是否为空。return_no 是微信回退单号,为空基本可判定回退单未真正建立;
  3. 若 return_no 非空,再用 return_no 或原分账单号反查一次,排除键的问题。

对账层面用双键:自有 out_return_no + 微信 return_no。任一为空即视为未闭环,不进入「已回退」口径。单靠 out_return_no 对账,会在「请求发出但没建成」的单上静默漏账。

三、日终三方比对口径

三方指分账单、回退单、退款单,按接收方维度(sub_mchid)逐日聚合。

先算应收未回退余额:

应收未回退余额
  = 原分账单已分给该接收方金额
  - 已 SUCCESS 回退累计金额
  - 仍在 PROCESSING 的回退金额

再与退款侧比对差额。差额为正说明退款已出、回退未回,是垫付敞口;差额为负说明回退已回、退款未出,是平台多出的资金。

SQL 示意(口径示意,非实测,表名字段按本地设计替换):

with share as (
  select sub_mchid, sum(amount) as shared_amount
  from profit_sharing_order
  where status = 'FINISHED' and result = 'SUCCESS' and dt = :biz_date
  group by sub_mchid
),
ret as (
  select sub_mchid,
         sum(case when result = 'SUCCESS'    then amount else 0 end) as returned_ok,
         sum(case when result = 'PROCESSING' then amount else 0 end) as returned_processing,
         sum(case when result = 'FAILED'     then amount else 0 end) as returned_failed
  from profit_sharing_return
  where dt = :biz_date
  group by sub_mchid
),
refund as (
  select sub_mchid, sum(amount) as refund_ok
  from refund_order
  where status = 'SUCCESS' and dt = :biz_date
  group by sub_mchid
)
select s.sub_mchid,
       s.shared_amount,
       coalesce(r.returned_ok, 0)         as returned_ok,
       coalesce(r.returned_processing, 0) as returned_processing,
       s.shared_amount
         - coalesce(r.returned_ok, 0)
         - coalesce(r.returned_processing, 0) as open_amount,
       coalesce(f.refund_ok, 0)           as refund_ok,
       coalesce(f.refund_ok, 0)
         - (s.shared_amount
            - coalesce(r.returned_ok, 0)
            - coalesce(r.returned_processing, 0)) as gap
from share s
left join ret r    on r.sub_mchid = s.sub_mchid
left join refund f on f.sub_mchid = s.sub_mchid
order by abs(gap) desc;

gap > 0:退款成功金额大于应收未回退余额,对应错位二,垫付敞口。
gap < 0:回退已回但退款未成功,对应错位一,平台多出资金。

另外单独出一张表:双键中 return_no 为空的记录,既不计入 returned_ok 也不计入 returned_processing,标记为「未建单」,人工补单或重发。

四、先退款后回退的敞口上限

敞口不是全量回退金额,只取「退款已成功但回退未终态」这一交集:

单日敞口上限 = Σ(当日退款成功、且对应回退单非 SUCCESS 的笔数 × 单笔金额)

按接收方和分账单聚合,PROCESSING 与 FAILED 未重试成功都计入。这个上限是时点值:回退单转 SUCCESS 后释放;转 FAILED 且不重试,则从敞口转为实际损失,需走其他追偿路径。

PROCESSING 的最长窗口是 5 天,超时置 FAILED(TIME_OUT_CLOSED),因此至少按 5 天滚动看这个指标,单日快照会低估。

五、边界项

  • 累计回退不超过原分账单分给该接收方金额;V3 同一分账单最多 50 次回退请求。超限失败不是余额问题,单独分桶。
  • 回退前提包括接收方 MERCHANT_ID、分账单 FINISHED、分账 result=SUCCESS、开启同意分账回退、180 天时限。任一不满足,回退单建不出来,return_no 为空。
  • FAILED 的 fail_reason 要分桶:ACCOUNT_ABNORMAL / PAYER_ACCOUNT_ABNORMAL 是账户问题,BALANCE_NOT_ENOUGH 是余额问题,TIME_OUT_CLOSED 是超时,INVALID_REQUEST 是参数设置失败。不同桶的重试策略和责任人不同。
  • HTTP 200 只是同步应答,result 可能是 PROCESSING,必须以查询或同号重发后的终态为准。

官方文档:

  • 分账回退(电商):https://pay.weixin.qq.com/doc/v3/partner/4012477737
  • 查询分账回退结果:https://pay.weixin.qq.com/doc/v3/partner/4012477740
  • 退款规则(B2b):https://pay.weixin.qq.com/doc/v2/merchant/4011984166

下一篇候选切面:回退单 FAILED 后的重试与追偿——按 fail_reason 分桶的重试窗口、重复请求的幂等键,以及 TIME_OUT_CLOSED 之后能否用新的 out_return_no 重建。

推荐文章

程序员茄子在线接单