启用验证试点前应验收什么?

先在免费沙盒中跑通流程,再准备生产接入。

统计选择在本站复用,可随时关闭;账号关联另行同意。

启用验证试点前应验收什么?

一个小型 B2B 团队已经跑通了合成身份入驻流程,希望申请真实的托管身份试点。要决定的不是 fixture 能否通过,而是在把试点结果当作对真实用户采取行动的许可之前,应当要求哪些证据。本文提出一份从合成环境到获批试点的验收清单,列出需要核对的精确 fixture 输出,并指出仍然缺失的证据。该清单是一种建议的应用设计,不是 GridZen 已实现的行为,也不授予生产访问权限。

curl https://gridzen.ai/console/api/quickstart/trial \
  -H 'Content-Type: application/json' \
  -d '{"task": "identity_onboarding", "scenario": "success"}'

接入指南

问题:fixture 通过不等于试点就绪

诱人的捷径是:运行合成示例,看到 approved 状态,就把集成当作已经证实,直接申请试点。实际上,fixture 只接受合成回调:事件 ID 必须以 fixture- 开头,来源必须是 fixture_callback,模式必须是 synthetic_fixture。任何其他模式或来源都会抛出 PRODUCTION_SIGNATURE_VERIFIER_NOT_IMPLEMENTED。它没有真实的签名验证器。其 recover 步骤只在本地将会话置为过期,从不轮询提供商。fixture 中授予的许可只是本地记录,每个输出都显示 live_permission_changed false。因此读者要回答的问题是:哪些由调用方负责的行为已经测试过,哪些仍需要真实证据?

假设场景与预期输出

假设一个负责卖家入驻的团队在本地运行可下载的四分支示例。该示例不同于匿名的三场景 HTTP 试用。创建会话应返回 mode synthetic_fixture、state simulated、session fixture-session、link_executable false,以及 next send_real_provider_link_only_after_authorization。policy 为 true 的 fixture-approved 事件应返回 status approved、deadline 60、permission_granted true、grant_count 1。重放同一事件应返回完全相同的记录,grant_count 仍为 1。之后的 Declined 更正应返回 status declined、permission_granted false、grant_count 1。在另一次运行中,若会话在截止时间后仍处于待处理状态,recover 应返回 status expired、permission_granted false、grant_count 0、next review_or_authorized_provider_refresh 和 provider_polled false。针对未知会话的事件应抛出 BINDING_MISMATCH,读取未知会话应抛出 SESSION_NOT_FOUND。

应用必须自行承担的失败处理

建议设计:将 unknown、review 和 expired 视为不授予许可的状态,并转入人工审核或经授权的提供商刷新,绝不把它们当作静默批准或静默拒绝。每个事件都要绑定 tenant 和主体。在授予任何许可之前,按会话和事件去重。收到 Declined 更正时要撤销本地授权。中断后应读取已有记录,而不是新建会话,并且每个请求使用一个幂等 UUID。如果注册流程包含电话检查,fixture 的 unknown 和 provider_failure 分支会返回 valid null,应分别转入 review_or_existing_otp 或 bounded_retry_then_review;两者都不会发送 OTP。

GridZen 实际已验证的内容

根据指南,一次真实的基础电话检查已通过已部署的 API 和 MCP 成功完成;一个先前已批准的运营方身份会话已通过客户接口刷新并读取。在托管身份方面,真实创建、签名通知、权威读取和过期均有证据。仍未验证的有:新会话的人工完成、新批准用户的真实最终 webhook,以及端到端的客户业务操作。运营方测试不代表客户需求。Approved 从来不是无条件许可,最终由您的规则决定。

需要核实而非假定的试点条件

经过验证的商户账户可以提交试点申请。负责人会审查用途、下游协议、供应商权利、能力、免费额度和到期时间。申请永远不会自动启用生产。当前面向符合条件的美国和英国企业的托管身份试用有明确上限:每个已验证企业域名 2 次请求,共享终身额度 10 次请求,并且需要另行接受 Didit 附加条款。试用仅覆盖已确认的免费模块,客户付款处于停用状态。银行账户匹配、KYB 和自动企业审批均不提供。免费额度不授予转售权,也不保证未来条款。

实用验收清单

申请前请逐项确认。1)上述七项 fixture 输出完全一致,包括两个错误码。2)缺少明确策略或账户绑定时,处理器拒绝授权。3)重复事件不会增加 grant_count。4)Declined 会撤销访问。5)expired、unknown 和 review 状态都会进入审核队列。6)恢复流程读取已有记录,绝不重复创建会话。7)已阅读能力说明,并记录了用途和下游协议。8)已记录缺失的证据:真实签名的最终 webhook、新批准的用户和实时业务操作,并在有限试点期间先验证这些内容,再依赖它们。下一步是运行合成示例并检查您的失败处理;只有在任务匹配时,才申请保存的沙盒。

运行已检查的模拟示例

下载并解压 https://gridzen.ai/downloads/verification-delivery.zip,进入 verification_delivery,用 Python 3.10+ 运行。此本地示例不联网;独立身份实验请使用新的数据库。

python3 delivery.py identity --db /tmp/gridzen-article-fixture.sqlite

来源与范围

https://gridzen.ai/guides/customer-pilot/ https://gridzen.ai/guides/current-capabilities/ 依据已检查的来源快照与本地模拟;建议的业务规则属于设计建议,不代表已证明的生产行为。内容使用 AI 辅助写作,并经过独立审稿。

另行体验三种沙盒结果 创建账号,继续项目接入

下载不等于运行成功;本地示例与在线沙盒分别测试。

接入你的应用

运行三种模拟结果 · 需要接入帮助

连接免费沙盒账号

号码基础有效性不证明持有权或送达,不提供短信验证码。业务放行由你的系统判断。