跳到主要内容

钱包与 DApp 集成

本组指南面向构建钱包前端、DApp 和支付入口的开发者。先明确要控制的账户、资产和支付路径,再选择 SDK 或商业收款接口。这里的产品行为说明不构成新的接口契约,也不代表每个发布版本都具备全部入口。

选择正确的接入层​

目标使用的文档应用承担的责任
商户创建托管收款会话商业支付快速开始保存订单和幂等键、服务端确认、幂等履约
钱包管理 Note 库存并构造交易SDK 钱包会话解锁、认证解密、持久化、签名授权、对账
钱包处理原生 IPP 支付IPP 支付校验固定 Request、遵循认证 links、保存原操作
查询公开协议数据Protocol RPC认证链事实,不将候选查询当作私密余额
展示公开资金来源信息Provenance保留认可范围,不推导现实身份或法律结论

不要把旧收款码解析器、App 的内部业务接口或演示页面当作稳定的第三方接入接口。商业 API 的币种单位十进制字符串,与 SDK/Core/原生 IPP 的最小单位金额不可混用。

集成顺序​

  1. 固定部署、网络、token 地址与精度,确认当前协议和 SDK 版本。
  2. 建立账户边界,区分连接、解锁、查看和签名能力。
  3. 分别同步公开余额和经过验证的私密库存,展示各自的新鲜度。
  4. 在确认页冻结资产、收款目标、金额、找零和费用。
  5. 在发送前保存操作,发送后保存哈希,恢复时对账原操作。
  6. 测试拒签、RPC 故障、重复点击、重启、余额不足与确认回滚。

按任务阅读​

产品设计稿中的示例网络、币种和费用只用于说明界面。实际执行以选定部署、接口能力与最终签名条款为准。