本阶段课程
  1. 原生币、ERC-20、ERC-721 与 ERC-1155
  2. 稳定币的发行、锚定与赎回
  3. 稳定币收款、退款与对账
  4. 稳定币支付与 PayFi
  5. 支付链案例:Tempo 与 Arc
  6. RWA 与现实资产代币化
  7. 代币化股票与链上证券
  8. 合成美元与收益型稳定币
  9. 托管、出入金与余额迁移
  10. 批量付款 · 工资、退款与补发
  11. 订阅与发票 · 周期、额度与取消
  12. 商户收银台 · 从支付链接到发货
  13. 支付账本 · 实收、商户应付与独立退款
  14. 支付路由 · 目标资产、限额与失败切换
  15. 汇率、结算批次与商户净收
本篇目录

阶段 05 · 第 3 / 15 课

练习 · 稳定币对账

稳定币收款、退款与对账

学完能做到:为商户订单设计付款确认、异常处理和退款记录。

建议先读:稳定币的发行、锚定与赎回。

先看一个场景

账单要求收 25 单位代币。订单收到两笔各 12.5,随后同一事件又重放一次,服务端需要正确累计但避免重复入账。

核心原理

对账将链上事件、商户订单、内部账务与结算记录匹配。退款通常是独立付款,需要完整保留原单与退款凭证。

需要区分的概念

订单记录应付、资产与到期;付款记录保留网络、代币与事件索引;汇兑记录报价和实际费用;退款需要审批与执行记录。

照着收银单走一遍

商户给订单 P-120 生成一张 25 USDC 的付款单。单上写明网络、接受的代币合约、收款地址和截止时间。用户提交付款后,界面先显示最新观察进度;商户用已验证、满足确认条件的事件核对应收和实收。

商户看到的情况 订单怎么显示 账务如何处理
还没发现匹配付款 待付款 保持原应收
只发现一笔已确认的 12.5 部分付款 记录一笔实收并保留 12.5 差额
同一事件又通知了一次 仍是部分付款 用链、哈希和日志序号认出重放
第二笔不同事件也已确认 12.5 足额付款 累计实收 25,履约任务按订单去重
其中一笔之后被重组撤回 需要重新确认 保留原流水及冲销记录,更新实收

用户发来截图时,客服可用截图里的哈希定位事件,但还需查订单网络、合约、接收方和实际金额。退款通常需要另发一笔付款,有自己的审批、状态与凭证。

计价和确认示例

账单 P-120 使用模拟 USDC,精度为 6,所以 25 USDC 写成原始整数 25,000,000。第一笔事件记为 TX-1#4,第二笔记为 TX-2#2。「#4」和「#2」是各自的日志序号。两条符合条件的事件各贡献 12,500,000,收到同一条 TX-2#2 的重试时只需核对已有记录。

异常 订单行为 账务处理
同笔事件重试 幂等更新确认状态 保留一条有效入账
错链或错资产 开异常工单,由运营核对 暂挂到可追溯记录
链重组 撤回原确认,按业务规则暂停交付 冲销失效记录后重放
退款延迟 已发起与已完成分开展示 核对退款回执和费用

退款金额、发送方和接收方由业务审批确定。处理链上事件时也要核对原单归属与用户输入,避免单凭转账备注定位业务订单。

动手练习

在交互实验室先提交一笔 12.5 USDC,再重放同一事件,验证累计金额仍为 12.5。接着提交第二笔 12.5 并撤回最近入账。比较界面状态和每条事件的结果,确认处理顺序可以重复核验。

先写下「待付款」「部分付款」「已确认」「已过期」「已退款」五种中文状态。给每个状态写一条证据和用户下一步。准备开发时,再选好代码里的名称与允许发生的状态变化,补上超付、错链与退款失败的用例。

自测

订单只收到 24.99,应自动标记成功吗?

查看参考答案

依据商户预先定义的容差和资产精度处理。无容差时记为部分付款,保留差额及补款或退款流程。

延伸阅读

记录本课进度

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

搜索课程