如何将您的客户记录与 Toden 连接
Charles Archibong, 联合创始人
使用稳定引用将应用程序中已有的客户与 Toden 记录关联起来。保留您已知的关于其验证来源的信息，而不是将导入的声明升级为已验证的事实。
要点
- 一个外部引用解析到目标记录。
- 进口确认和进口完成是不同的。
- 失败的行仍然可以解释和重试。
- 进口产品保留真实来源。
- 有范围的重新吸引将附加到现有客户身上。
将应用程序中已有的客户连接到 Toden 使用稳定的参考文献进行记录。保留您已知的验证来源信息，而不是将导入的说法升级为已验证的事实。
开始之前
稳定的客户推荐
已授权的导入或配置文件管理访问权限
请使用具有此控制权限的团队成员。更改设置前，请检查组织和环境。付款或持续注册前，请审核当前价格。屏幕截图显示的是示例工作区或公共集成参考；它们不显示真实客户或已完成的付款。
设置并使用该功能
第一步：选择一个稳定的客户作为参考
使用您系统中持久有效的客户或企业 ID 作为externalUserId 。在导入、验证和活动过程中，同一主体应使用同一个参考编号。确定主体是个人还是企业。请勿使用可能更改的电子邮件地址作为唯一的客户密钥。获取传输您计划注册的个人资料详细信息的权限。
集成参考：注册或更新实体
步骤二：选择正确的产地
使用 UNVERIFIED 用于尚未完成验证的记录。 EXTERNAL_VERIFIED 仅当您获得授权时 KYC 流程已通过真实可靠的KYC 来源验证。请勿声称 MYAZA_VERIFIED 导入外部记录仅仅是为了解锁某项功能。身份链接和风险证明依赖于各自的合约；已声明的钱包并不等同于所有权证明。
集成参考： KYC 溯源与身份解析
步骤 3：从后端注册一条记录
称呼 POST使用密钥和客户的 externalUserId、类型和允许的配置文件，通过 /api/identity/entities 进行访问。仅提供已知信息。重用同一客户引用会更新现有实体，而不是创建新实体。请谨慎处理元数据替换语义，并将返回的 entityId 存储在您的应用程序记录中。
集成参考：请求
步骤 4：发送活动之前，先读取记录。
取回 GET 运行 /api/identity/entities/{externalUserId}并将返回的主体、来源和允许的配置文件与预期记录进行比较。单独审查筛选注册。 INACTIVE 表示筛查未启动； QUEUED 尚未完成清晰检查。请保留 Toden 实体 ID 和您的外部引用不同，以便后续评估使用端点的预期主题形式。
集成参考：查找实体
步骤 5：使用异步作业导入更大的书籍
要使用支持的批处理，请调用 POST 使用文档中规定的注册格式，通过`/api/identity/entities/import`导入 1 到 1000 个条目。存储 202 响应返回的 jobId。轮询作业进度直至其完成，然后检查成功、失败和待处理的数量以及有界失败的详细信息。已确认的导入并不代表所有行都已成功导入。
集成参考：批量导入
步骤 6：修复故障并连接下一项功能
在重试之前，请先将失败的客户参考信息与源数据进行核对。切勿使用虚假值重新导入已成功的记录。记录一旦存在，请使用相同的参考信息链接捕获数据，或发送受支持的帐户活动信息。明确的风险评估和监控可能需要返回的实体 ID 和单独的激活信息。请保留客户级别的错误和作业证据以供支持。
集成参考：评估或监控现有客户
充分发挥这种能力
当个人资料名称或电子邮件发生更改时，请保持客户参考编号不变。
使用真实可靠的外部验证来源，并保留来源信息，以便审阅者了解其出处。
将钱包地址视为有范围的风险属性，而不是全局身份密钥或转账权限。
先测试再依赖它
运行此产品支持的沙箱或模拟器场景。如果某个工具仅供生产环境使用，请先检查访问权限和范围，然后仅使用经过审核的、获得许可的生产环境测试。文档截图或页面加载成功并不等同于端到端集成测试。
一个外部引用解析到目标记录。
进口确认和进口完成是不同的。
失败的行仍然可以解释和重试。
进口产品保留真实来源。
有范围的重新吸引将附加到现有客户身上。
故障排除
一批货物返回了 202 条记录，但缺少部分记录。
要关注一项持久性工作的进展和失败，而不是认为得到认可就意味着完成。
个人资料编辑请求被拒绝
检查合同允许在已验证记录中使用哪些字段。不要通过通用补丁覆盖已验证的身份信息。
评估无法找到客户
检查该端点所需的组织、环境、引用类型和实体 ID。
打开设置和集成参考
返回解决方案 （在新标签页中打开）。选择要激活的功能，然后按照其相应的指南进行操作。
参考来源
