批量付款 · 工资、退款与补发
学完能做到:为多笔付款设计审批、批次、部分失败和逐笔对账。
先看一个场景
商户要给 80 位参与者返还押金。前 79 笔成功,一笔因地址格式错误尚未发出。退款批次应保留逐笔结果,重试时只补发失败项。
控制点
| 环节 | 证据 | 需要处理的异常 |
|---|---|---|
| 生成批次 | 上游订单 ID、币种、链和应付金额 | 重复退款、未知地址 |
| 审批 | 总额、收款清单摘要和经办角色 | 付款名单在审批后变更 |
| 执行 | 每项的请求 ID、交易和事件索引 | 批次部分失败、费率超限 |
| 入账 | 逐项金额、费用和结果 | 同一交易出现多个退款事件 |
| 补发 | 原失败项、重试理由和新记录 | 已付款项请求重复 |
有的批量付款遇到一项错误就整笔停止,有的流程允许其他项继续。即使只有一笔链上交易,也可能包含多条付款记录。对着回执检查实际成功的是哪几笔。审批过的名单要保留版本,有人改金额或收款人时重新核对审批。
试着把三笔退款看成三个子订单
批次 R-1 已审批,清单是 A 退 7、B 退 10、C 退 13,共 30 个模拟单位。系统第一次执行后,A 和 C 有成功凭证,B 提交失败。此时实付累计是 20,尚有 10 要处理。
| 子项 | 第一次结果 | 恢复时记录什么 |
|---|---|---|
| R-1/A · 7 | 成功 | 保留原付款凭证,跳过补发 |
| R-1/B · 10 | 失败 | 再确认没有成功付款,给同一子项准备新尝试 |
| R-1/C · 13 | 成功 | 保留原付款凭证,跳过补发 |
如果列表里的 B 只是「状态未知」,先查原请求或交易状态。只有查明失败,才根据授权和金额规则决定补发。补发成功后实付累计应为 30。批次用于组织多笔付款;子项用于记录每一笔的业务义务;尝试编号用于保留同一笔付款的提交和重试历史。
动手练习
创建 3 笔模拟退款,金额 7、10、13。将中间一笔标为失败,重放同一批次,验证实际发出累计 30,并保留一次失败记录及手续费。
自测
同一交易哈希里发出 3 条相同代币的付款事件,怎样避免漏记?
查看参考答案
按链 ID、交易哈希与日志索引区分,再匹配批次子项、收款人和金额。哈希只标识交易,子项之间仍各自需要会计凭证。