本阶段课程
  1. 项目一 · 钱包资产与交易状态
  2. 项目二 · 兑换报价与状态机
  3. 项目三 · 稳定币收款与对账
  4. 项目四 · 协议评审与产品设计
  5. 中文术语速查
  6. 项目五 · 链上支付上线与故障演练
  7. 项目六 · 搭一个可验收的链上收银台
本篇目录

阶段 10 · 第 7 / 7 课

项目六 · 搭一个可验收的链上收银台

学完能做到:结合界面、模拟回调、订单状态与故障验收,交付完整支付流程。

先看一个场景

课程项目要在手机和桌面完成一次模拟付款,并允许第三方按测试数据重放。服务端使用固定样本模拟链上事件和异常,页面只读取订单结果并解释下一步。

分成四个交付物

交付物 需要看到什么
页面 应付资产、网络、付款地址、订单状态与过期时间
订单接口 状态、历史事件、确认规则和业务操作 ID
模拟监听 事件输入、验收结果、去重日志与手工撤回
验收脚本 25 USDC 正常、两笔 12.5、重放、错资产与重组样本

建议先通过交互实验室理解对账状态,再按收银台课程设计网络接口。应用与数据使用模拟账户,提交时附上 Markdown 使用说明。

给第一次动手的人一份开工顺序

一、先在纸上写对账单

创建模拟订单 P-120,应收 25 USDC。记录教学网络、代币合约标识、收款地址和小数精度。先让页面可以清楚展示应收,然后准备五行记录:正确付款、分两笔付款、重复事件、错资产及事件撤回。

二、把初始界面接到订单结果

界面按订单查询返回待付款、部分付款、已确认或待核对。模拟监听每次接收事件后,服务端核验并更新订单,前端继续查询和显示。第一版可以用本地函数和文件数据完成。做成接口时,再验收刷新页面后仍能查同一笔结果。

三、在移动端完整重放一遍

重放到哪一步 应看到
第一笔 12.5 已确认 部分付款,剩余 12.5
同一事件通知重来 累计不变
第二笔 12.5 已确认 足额,按规则生成一次履约动作
第二笔被撤回 累计退回 12.5,记录冲销原因
同名错资产到达 提示核对,保留异常记录

最终交付应包含页面截图、原始事件表、可复现操作和预期结果。把测试数据交给同伴,要求从空状态重放并核对每一步。如果哪一步只能靠开发者口头解释,就把说明放进交付材料。

关键验收

  1. 已支付订单再次打开会显示已确认。重复回调保持一次发货。
  2. 先付 12.5 进入部分付款,第二次足额后进入确认。错资产保留异常记录。
  3. 事件撤回后能冲销,保留历史原因。刷新及换页可恢复同一个订单。
  4. 手机可核对网络和资产,键盘能访问所有表单。错误文案能告诉用户做什么。

自测

模拟服务重启,前端本地缓存还是「已支付」时,可以直接展示可发货吗?

查看参考答案

要向订单服务重新确认状态。缓存可以标为上次观察,不能替代后端已经对账的状态及履约记录。

记录本课进度

完成练习后标记。进度保存在当前浏览器。

搜索课程