跳到主要内容

普通付款

mode=payment、method=invisi 要求付款人向本次 Request 的独立 identity 支付指定资产与金额。金额采用资产最小单位的规范十进制字符串,不经过浮点数。6 位精度资产的 "10000000" 表示 10 个 token。资产身份由链、Core 和 token 地址确定,展示符号不能替代校验。

确认和钱包执行​

先读取 Session 并显示选项,再通过 links.confirm 确认。服务端冻结所选 option 的链、资产和金额,为本次付款生成收款 identity,并保存预期 Note commitment。钱包核对 Request 与选项一致,验证受信 Core 部署后构造支付输出。不要将 Session options 当作已确认的执行要求。

以下是 PaymentRequest 的 payment 字段片段,不是完整响应。地址与 identity 均为占位值,执行前使用认证响应中的实际值:

{
"payment": {
"network": "eip155:8453",
"protocolAddress": "0x3333333333333333333333333333333333333333",
"tokenAddress": "0x1111111111111111111111111111111111111111",
"amount": "10000000",
"recipient": {"type": "identity", "identity": "0xEXAMPLE_RECEIVER_IDENTITY"}
}
}

服务端保管 Note nonce 等收款材料,付款人仅取得所需 identity。幂等确认和跨设备恢复必须复用原 identity、requestId 与截止时间。钱包依据所选 SDK 的执行接口生成证明并广播;IPP 不定义额外的付款人身份签名。

可选 Credential​

广播后可以向 Request.links.credentials 提供定位提示。以下是完整消息结构;所有 ID 和哈希均须替换为本次真实值。操作需要 Session Token,HTTP 202 只表示受理:

{
"ippVersion": 1,
"type": "credential",
"mode": "payment",
"method": "invisi",
"sessionId": "ses_EXAMPLE",
"requestId": "req_EXAMPLE",
"proof": {
"type": "note",
"transactionHash": "0xEXAMPLE_TRANSACTION_HASH",
"commitment": "0xEXAMPLE_NOTE_COMMITMENT"
}
}

不提交 Credential 也应完成后台发现。错误候选不能覆盖原要求或使其他有效付款失效。Credential 不含私钥、Note opening 或待广播交易。

服务端如何确认到账​

Facilitator 根据持久化要求重算预期 commitment,在固定部署通过 Protocol RPC invisi_getNote 获取 finalized 证据,检查成功交易、输出事件、资产、成员路径、规范块和确认上下文。仅有 txHash、safe 或 membership 不足以核销;不能回退到较弱确认策略。

预期 commitment 绑定金额;RPC 不需要接收私密 opening。商户之后归集或花费 Note,不抹去历史到账证据。

成功前 receipt=null。验证与唯一消费记录原子提交后,Session 变为 succeeded,receipt 保存 network、protocolAddress、transactionHash、commitment、blockNumber、blockHash、completedAt。商户通过自己的认证查询确认回执与当前 evidenceStatus,对原订单幂等履约;客户端复制的 JSON 不构成可独立信任的签名回执。

额外或迟到到账记入异常,不能让失败会话重新成功。恢复规则说明何时等待、恢复原交易及处理异常。