地址、收款码与支付请求
先识别输入的对象
| 输入 | 可表达什么 | 执行前还需确认 |
|---|---|---|
| 普通链地址 | 该网络上的收款账户 | 网络、资产、金额与接收方控制权 |
0i 隐私地址 | 协议定义的公开收款材料 | 对应编码格式、部署、资产和支付路径 |
| 短地址 / 别名 | 需解析的地址标识 | 当前解析结果、注册状态和完整接收材料 |
| 收款码 / 链接 | 编码的地址或带条款的请求入口 | 格式、来源、固定 Request 与受信服务 |
| 交易哈希 | 已提交交易的公开定位信息 | 不可把它当作收款地址或花费凭证 |
0i 前缀不是“已确定链和币”的保证。完整隐私地址不编码 chain ID;应用应独立选择网络和资产。短地址不是简单截断:不要把用于显示的 0i… 缩写或含省略号的字符串交给编码器。
接收端的生成流程
- 确定普通接收还是隐私接收,以及当前账户。
- 固定网络和实际 token 标识,读取相应能力。
- 按当前接口创建支付请求,或编码普通地址及支持的参数。
- 显示最终绑定的币种、网络、可选金额和备注。
- 对真实载荷生成可扫描二维码;复制、保存图片和分享使用同一个最新载荷。
切币、切账户或改金额后,旧二维码可能对应旧条款。使用请求序号或取消机制防止较慢的旧响应覆盖新请求;生成中禁用旧码的复制、保存和分享,或明确说明旧码不再适用于当前界面。编码失败应显示错误,不用装饰图案替代真实二维码。
付款端验证
原生 IPP 先读取 Session、展示选项,再确认并取得固定 Request。沿认证 links 进行后续交互,并检查所选资产、网络、金额、部署、收款目标和截止条件。详见IPP 支付。商业 Checkout 的 API Key、金额单位和状态模型另见商业支付。
不因某个 URL 能打开就把它视为可信。解析深链时使用允许的协议与路径;外部 endpoint 需要来源和目标校验,不能任意跟随其 URL 去携带用户凭据或访问本机/内部服务。服务端不可用时保留原请求供重试,不伪造新收款目标。
二维码与验收
- 使用实际载荷做生成—解码往返测试,不能只截图看外观。
- 覆盖长地址、长请求、不同币种精度、中文备注、导出图片与缩放。
- 不超过编码器容量,保留静区与对比度;中心 Logo 不应破坏可识别性。
- 分别测试 App 扫码、网页复制、外部钱包打开以及用户拒签。
旧版 IPP 收款码与当前原生 IPP Request 可能不是同一线格式。接入以版本兼容性指定的解析器和契约为准,不能仅凭 ipp 或 0i 前缀复用旧实现。