如何使用 Toden 为您的应用添加验证功能
Charles Archibong, 联合创始人
使用已发布的流程和受支持的 SDK 或托管会话，为您的应用添加验证功能。将客户旅程中的数据采集和最终结果处理保留在您的后端。
要点
- 该应用程序会打开预期发布的流程。
- 机密凭证保存在后端。
- 已取消、已过期和已放弃的行程均已处理。
- 最终结果符合目标客户的需求。
- 生产环境使用自己的工作流程、密钥和接收器。
使用已发布的流程和受支持的方法，为您的应用添加验证功能。 SDK 或托管会话。将客户旅程中的数据采集和最终结果处理保留在您的后端。
开始之前
已发布的工作流程
所支持的 SDK 或托管会话路径
您的服务器检索最终结果
请使用具有此控制权限的团队成员。更改设置前，请检查组织和环境。付款或持续注册前，请审核当前价格。屏幕截图显示的是示例工作区或公共集成参考；它们不显示真实客户或已完成的付款。
设置并使用该功能
步骤 1：发布客户应使用的工作流程
打开配置 →沙盒中的工作流。创建或打开相应的个人、业务或范围工作流。仅配置所需的捕获和审核检查。保存并发布，然后复制工作流 ID。集成前请检查组织和环境。未发布的工作流不是可重用的实时捕获配置。
仪表盘示例：发布客户应使用的工作流程
步骤 2：选择嵌入式捕获或托管会话
使用网络 SDK 浏览器端截图使用 React Native 或 Flutter，原生移动端截图使用 React Native 或 Flutter，当需要已知申请人的链接时，则使用托管会话。原生应用独有的功能包括： NFC 需要使用原生路径。共享工作流链接可供多个申请人使用；服务器创建的会话仅属于单个申请人。请选择与您的产品匹配的路径，而不是混用他们的凭据。
集成参考：运行工作流的三种方式
步骤 3：安装当前支持的版本 SDK 并配置捕获
关注你所在平台的动态 SDK 本指南包含受支持软件包、所需对等依赖项和权限声明的说明。请传递workflowId 、匹配的可发布API 密钥和您的稳定用户 ID 。工作流将提供已配置的步骤；运行时主题数据将保留在您的应用程序中。在排查忽略工作流 ID 的流程问题之前，请先查看文档中记录的最低工作流启用版本。
集成参考：工作流
步骤 4：对于托管捕获，请在后端生成会话。
称呼 POST使用私钥、已发布的流程 ID 和目标 externalUserId 访问 /api/kyc/sessions 。仅在需要时添加允许的预填充项和元数据。存储会话引用并提供私钥。URL 发送给目标申请人。工作流程快照在生成时即已固定。请勿将密钥放置在 WebView、移动版本或浏览器包中。
集成参考：请求
第五步：记录提交情况，然后等待结果
这 SDK 提交回调函数用于识别提交操作，但并非最终的批准回调函数。请将其验证引用存储在后端。使用允许的权限读取当前状态。 API 或接收已签名的 Webhook。区分处理中、人工审核、等待重新提交、错误和最终结果。使用checkStatus及其说明读取最终状态，尤其是在决策等待其他检查结果时。
整合参考：各州
步骤 6：测试完整流程并单独准备生产环境。
使用受支持的沙盒 ID 和测试夹具进行捕获、状态和接收器测试。执行权限拒绝、放弃、重试、审核和拒绝操作。对于生产环境，请获得业务批准，发布生产工作流程，配置与环境匹配的密钥和结果接收器，并审核当前定价。沙盒测试通过仅验证您的操作，并不能证明每个实际运行的检查或设备都能正常工作。
集成参考：上线检查清单
充分发挥这种能力
允许工作流发布更改捕获配置，而无需在每个应用程序构建中重复该配置。
使用元数据进行允许的关联，例如应用程序引用，但要保持在文档规定的范围内。
测试手机切换、权限恢复和浏览器托管事件，确保其与您实际发布的流程兼容。
先测试再依赖它
运行此产品支持的沙箱或模拟器场景。如果某个工具仅供生产环境使用，请先检查访问权限和范围，然后仅使用经过审核的、获得许可的生产环境测试。文档截图或页面加载成功并不等同于端到端集成测试。
该应用程序会打开预期发布的流程。
机密凭证保存在后端。
已取消、已过期和已放弃的行程均已处理。
最终结果符合目标客户的需求。
生产环境使用自己的工作流程、密钥和接收器。
故障排除
这 SDK 忽略 workflowId
检查已安装软件包版本是否符合文档规定的最低版本，并验证已发布的工作流程。
未找到工作流程。
匹配密钥、组织、环境和已发布的 ID。
我的应用在 onSubmit 事件触发后立即启动。
等待最终权威状态确认，不要将提交捕获内容视为批准。
打开设置和集成参考
返回解决方案 （在新标签页中打开）。选择要激活的功能，然后按照其相应的指南进行操作。
参考来源
