授信与后续扣款
mode=credit 建立付款人向 spender 的扣款授权。授信不是到账、预充值或锁仓,也不保证未来余额充足。纯授信成功不能放行一笔要求实际付款的 API 调用;每次后续扣款需要独立执行和到账判断。
条款与确认
| 字段 | 含义 |
|---|---|
| spender | 被授权商户的完整 Invisi 地址,执行前解析核对身份 |
| availableCredit | 有限模式的初始可用额度,扣款后递减 |
| unlimited | 取消有限额度约束,其他限制仍适用;true 时 availableCredit 使用 "0" |
| singleLimit | 单笔上限,"0" 表示不启用 |
| dailyLimit / monthlyLimit | UTC 日历日/月累计上限,"0" 表示不启用 |
| credit.expiresAt | 授信长期有效期,必须覆盖 Request 的执行截止 |
| initialPayment | 可选的创建并首扣要求,amount 为商户净实收 |
金额均为最小单位字符串。有限模式的初始 availableCredit 必须为正;单笔/日/月限额须符合 uint126 范围,availableCredit 符合 uint128 范围。每日/月上限按 UTC 日历边界计算,不能解释为从授权日起滚动的订阅周期。
确认后 CreditRequest.credit 增加 operation=create、network、protocolAddress、tokenAddress 与 creditSharedKey,冻结全部条款。下面是纯授信条款片段,用于说明结构,不是完整选项或 Request;spender 是占位值:
{
"credit": {
"spender": "0i_EXAMPLE_MERCHANT_RECEIVING_ADDRESS",
"availableCredit": "1000000000",
"unlimited": false,
"singleLimit": "10000000",
"dailyLimit": "50000000",
"monthlyLimit": "300000000",
"expiresAt": "2027-11-20T08:00:00Z"
}
}
钱包与证据绑定
钱包必须使用认证 CreditRequest 返回的 creditSharedKey 原值,不能重新随机生成或二次派生。SDK 必须支持显式传入该密钥;请先确认所选版本的能力。密钥只在认证 Request 中交付,不进入 Session options、入口 URL、日志或 receipt,也不替代 owner 的链上授权。
钱包准备其余状态、证明和加密投递并执行。Facilitator 解密 spender 投递,匹配共享密钥,重算 commitment,核对完整条款与 owner、原撤销位置;再在同一 finalized 快照检查规范创建回执、成员路径、消费状态、撤销位图和有效期。普通 Note 查询不能代替 Credit 验证。
纯授信初始状态在首次核销前已被消费、更新、撤销或到期时,不能伪造 active receipt。成功 receipt 中的 creditId 是稳定逻辑标识,commitment 随后续状态变化;creditStatus 与 verificationBlock 描述当次验证快照,不能证明查询时仍有额度。后续 draw/update/revoke 不重跑创建 Checkout,也不改写历史 receipt。
可选创建并首扣
仅在服务、部署、钱包与广播链路均支持时发布 credit.initialPayment。不支持的客户端必须拒绝,不能退回纯授信。option 与 Request 中的首扣 amount 必须一致。
首扣支付给同一 spender,使用同一链、Core 和 token。owner 签名前须明确净额、实际费用和总扣款:grossAmount = amount + feeAmount。限额与可用额度按 grossAmount 消耗,商户 Note 按净额建立。首扣由 owner 的组合授权覆盖,无额外商户签名接口。
服务须同时验证同一成功交易中的授信创建与首款 Note,才原子核销一次。receipt.initialPayment 包含 noteCommitment、grossAmount、netAmount、feeAmount、feeRecipient。首扣恰好耗尽有限额度时可为 creditStatus=depleted。后续独立扣款不能替代缺失的首扣证据。
Facilitator说明后续商户扣款与保管职责;恢复规则说明未知交易结果与迟到授信的处理。