商户收银台 · 从支付链接到发货
学完能做到:用订单与付款状态设计结账页面和服务端回调。
先看一个场景
用户在两个标签页打开同一笔 25 USDC 账单。一个页面扫码成功,另一个页面网络超时。商户后台需要让两页看到同一订单状态,同时避免多发一次货。
对照收银台与后端
| 前端展示 | 后端证据 | 交付动作 |
|---|---|---|
| 待付款 | 账单创建、资产与额度有效 | 打开付款入口 |
| 确认中 | 发现匹配事件并等待确认 | 跨页面轮询订单状态 |
| 支付完成 | 实收足额、确认满足与业务校验通过 | 排队进行一次发货 |
| 部分或超额 | 实收与应收不同 | 补款或异常处理 |
| 已退款 | 独立退款交易完成 | 提供退款凭证 |
回调只能作为状态变更线索。服务端应校验来源、顺序及唯一事件标识,并按订单数据重新验证金额和资产。把发货任务存为可重试操作,遇到队列或仓库超时可查询既有任务进度。
用一次支付完成收款和发货
商户订单 P-120 应收 25 USDC。用户付款后,浏览器先看到「确认中」。监听服务收到事件 TX-8#3,核对链、代币合约、接收方和金额,再等待符合业务规则的确认。后台在一次状态变更里记录已支付与待交付的动作,之后发货队列处理。
模拟仓储服务响应超时时,订单可以保持已支付,履约记录标记为待查询。恢复时先用订单和动作标识查旧任务,再决定是否重试。这样用户不需要重新付款,商户也能避免重复发货。
订单 P-120 应收 25,确认后状态已支付
事件 TX-8#3 匹配正确资产和地址,同一事件只记录一次
发货 F-120 初次发送超时,需要查询原任务
核对结果 已有仓储单号,继续用原单更新订单
再模拟支付凭证被重组。务必保存原记录和冲销,明确何时暂停待发货任务,已发货则走后续处理而非删除实际履约。
动手练习
绘制收银台、支付监听、账务和仓储四方时序。回放「前端超时但足额」「重复回调」「退款晚于物流发货」三条链路,写出前端显示与后台处理。
自测
浏览器报告「支付成功」,是否就可以把订单状态设为已支付?
查看参考答案
订单服务使用事先定义的链上事件、付款金额和确认规则核验。前端状态只供展示或提示查询。状态更新与发货应避免并发重复。