跳到主要内容

IPP 支付与授信协议

IPP 为钱包、Agent、商户与支付服务定义共同的支付交互。mode 表示业务目的(payment 或 credit),method 表示执行方式(如 invisi)。一个 Session 只属于一种 mode,可提供不同链和资产的选项。

本节介绍原生 IPP。使用InvisiPay 托管 商户 API 时,遵循商业支付文档;它的资源、认证和商业确认等级有独立契约。

从 Checkout 到回执​

商户创建 Checkout → 读取 PaymentSession → 确认一个 option
→ 不可变 PaymentRequest / CreditRequest
→ 钱包授权和执行 → 服务发现、验证证据并原子核销
→ GET 原 sessionUrl → 状态、receipt、异常摘要
对象对接用途
Checkout商户创建得到的启动对象,提供 sessionUrl、checkoutUrl、expiresAt
PaymentSession选项、当前状态、唯一 activeRequestId、receipt 和异常摘要
PaymentRequest本次支付的链、Core、资产、金额和收款 identity
CreditRequest本次授信创建的条款、spender 和受保护的共享密钥
Credential可选交易定位提示;不构成付款证明或资金授权
receipt成功核销后嵌入 Session 的不可变历史记录

一个 Checkout 对应一个 Session、一个确认后固定的 Request,最多产生一份成功 receipt。创建时不生成具体收款材料;确认选项时才原子保存材料与要求。重复确认同一选项恢复原 Request,不延长执行时间或换一套密钥;换选项会冲突。

各方如何协作​

商户管理订单和调用者身份,选择 Facilitator 并保存订单关联。钱包核对条款、生成证明、取得用户授权,自行广播或使用 Broadcaster。Core 约束实际资金和授权操作。Protocol RPC 提供受信的链上事实与最终性依据。Facilitator 管理 IPP 对象,通过 RPC 主动发现、验证并核销。

Facilitator 的 HTTP 支付服务不构造、签署或广播付款人的交易,也不直接访问链节点。客户端关闭页面或不提交 Credential,后台仍继续核对。GET 只读取状态,不核销或履行业务。

选择接入路径​

商户使用 Facilitator 接入流程创建并交付会话。钱包从受信商户收到 sessionUrl 与会话能力后,跟随响应中的完整操作链接;不要从对象 ID 推测路径。

普通付款解释金额、收款材料与到账验证;授信与后续扣款解释授权额度与可选首扣;授权、截止与恢复解释 Token、幂等、失败终态和异常。部署与信任要求见 Facilitator。