跳到主要内容

Facilitator

Facilitator 为原生 IPP 提供 Checkout、会话、不可变要求、证据验证与自动核销服务。适合自建收款服务、钱包和 Agent 集成。InvisiPay 托管 接入使用商业支付的独立契约。

服务边界​

商户服务创建 Checkout,付款客户端确认选项并执行。Facilitator 通过受信 Protocol RPC 持续发现链上事实,在 finalized 条件和截止时间内原子核销,再向查询者返回 Session、receipt、evidenceStatus 与 exceptionSummary。不需要商户另行调用核销接口;GET 只读。

付款 HTTP 服务不构造、签署或广播用户交易,不接收 payer witnesses 或私钥,不直接读取链节点。付款人使用钱包和 SDK,自行广播或使用 Broadcaster。运营方另有显式的钱包归集和授信扣款命令,使用商户的收款/spender 权限;这些命令不属于付款客户端的 IPP 请求。

接入前准备​

选择运营方提供的 HTTPS 服务地址和商户 API Key,确认支持的链、固定 Core 部署、资产及 finalized 能力。IPP v1 消息版本与 Core 部署版本独立,不能仅因 HTTP 路径含 v1 就判断兼容。

商户需要在服务端保存凭据、Checkout 与本地订单/API 操作的绑定和创建幂等键;预先选择可信收银台。默认收银台入口使用 https://dapp.invisipay.fi/checkout,实际入口以创建响应为准,运营方可配置其他受信前端。浏览器 origin 必须在服务的 CORS 策略中获准,CORS 不代替认证。

发布授信选项前,确认钱包支持服务端指定 creditSharedKey,服务可解密配置 spender 的投递,RPC 可提供完整一致快照。创建并首扣还需客户端和广播链路支持组合操作;不能根据协议定义假定每个服务已经开放该能力。

HTTP 接入流程提供凭据隔离、端点和示例;截止与恢复规定结果未知时的动作。

自建服务的信任与保管​

Protocol RPC 是规范链与 finalized 状态的信任来源。固定链、Core 与部署元数据,禁止客户端指定验证源;依赖异常时等待或返回错误,不能降低最终性或以“查不到”断言没有付款。最终性冲突期间停止受影响部署的新核销,保留历史证据。

服务加密保存私密 Session/Request、Note 收款材料与 creditSharedKey。备份数据库及所有历史存储密钥;没有 ciphertext 的 Checkout Note 需要原收款材料才能恢复。收款 keystore 与密码分开备份,切换钱包不迁移旧 owner 的资金。

显式 CLI 归集/扣款可能使用热钱包花费权限,冷钱包私钥保持离线。离线 inventory/status 是缓存,不能用作最新资金或可用授信的证明。后续扣款须再次验证当前状态和限额,并用持久 operation ID 恢复未知提交,不能超时后另建扣款。

安全与信任提供跨组件说明。安装包、运行环境和支持能力由所选运营方的部署说明确认;本页的示例不指定公开可用的 Facilitator 实例。