跳到主要内容

地址、收款码与支付请求

先识别输入的对象​

输入可表达什么执行前还需确认
普通链地址该网络上的收款账户网络、资产、金额与接收方控制权
0i 隐私地址协议定义的公开收款材料对应编码格式、部署、资产和支付路径
短地址 / 别名需解析的地址标识当前解析结果、注册状态和完整接收材料
收款码 / 链接编码的地址或带条款的请求入口格式、来源、固定 Request 与受信服务
交易哈希已提交交易的公开定位信息不可把它当作收款地址或花费凭证

0i 前缀不是“已确定链和币”的保证。完整隐私地址不编码 chain ID;应用应独立选择网络和资产。短地址不是简单截断:不要把用于显示的 0i… 缩写或含省略号的字符串交给编码器。

接收端的生成流程​

  1. 确定普通接收还是隐私接收,以及当前账户。
  2. 固定网络和实际 token 标识,读取相应能力。
  3. 按当前接口创建支付请求,或编码普通地址及支持的参数。
  4. 显示最终绑定的币种、网络、可选金额和备注。
  5. 对真实载荷生成可扫描二维码;复制、保存图片和分享使用同一个最新载荷。

切币、切账户或改金额后,旧二维码可能对应旧条款。使用请求序号或取消机制防止较慢的旧响应覆盖新请求;生成中禁用旧码的复制、保存和分享,或明确说明旧码不再适用于当前界面。编码失败应显示错误,不用装饰图案替代真实二维码。

付款端验证​

原生 IPP 先读取 Session、展示选项,再确认并取得固定 Request。沿认证 links 进行后续交互,并检查所选资产、网络、金额、部署、收款目标和截止条件。详见IPP 支付。商业 Checkout 的 API Key、金额单位和状态模型另见商业支付。

不因某个 URL 能打开就把它视为可信。解析深链时使用允许的协议与路径;外部 endpoint 需要来源和目标校验,不能任意跟随其 URL 去携带用户凭据或访问本机/内部服务。服务端不可用时保留原请求供重试,不伪造新收款目标。

二维码与验收​

  • 使用实际载荷做生成—解码往返测试,不能只截图看外观。
  • 覆盖长地址、长请求、不同币种精度、中文备注、导出图片与缩放。
  • 不超过编码器容量,保留静区与对比度;中心 Logo 不应破坏可识别性。
  • 分别测试 App 扫码、网页复制、外部钱包打开以及用户拒签。

旧版 IPP 收款码与当前原生 IPP Request 可能不是同一线格式。接入以版本兼容性指定的解析器和契约为准,不能仅凭 ipp 或 0i 前缀复用旧实现。