稳定币收款、退款与对账
学完能做到:为商户订单设计付款确认、异常处理和退款记录。
建议先读:稳定币的发行、锚定与赎回。
先看一个场景
账单要求收 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,应自动标记成功吗?
查看参考答案
依据商户预先定义的容差和资产精度处理。无容差时记为部分付款,保留差额及补款或退款流程。