docs(汇安融): 10.5 的回调兜底提醒补上退款这条
10.5 原来只写了「给长期停在 0 的订单做主动查询兜底」——退款上线后,
订单还会停在 "4"(退款中),而那正是**等钱**的状态,比 "0" 更要紧:
停在那儿意味着用户的钱退没退还不知道。
补一条说明退款终态走同一条回调(content.status + refund_time),
以及 "4" 同样需要主动查询兜底。
顺带记下这次量到的代码事实(写文档时的依据):
- notifyEnterprise 全仓只有 1 个调用点(HarNotifyService.handle),
即**只有上游推了通知才会回调下游**;主动查询那条路
(syncFromUpstream → applyQueryDetail)不回调。
- 而 HarOrderService:405 的注释自己写着「上游通知重试窗口只有约 25 秒,
超过即永久丢失,因此主动查询是状态收敛的主路径,不是兜底」。
两者合起来 = 退款收敛到 "2" 这件事,下游多半收不到回调。
只改 md,不动代码。「轮询收敛后也补一条回调」是另一件事,需要设计
(去重、与通知路重复投递、notify_status 语义),未裁定。