Skip to content
全部文章

如何使用 Toden 检查和监控地址是否存在

查尔斯·阿奇邦

, 联合创始人

在支持的观察窗口期内验证地址是否存在。同时配置捕获、原生报告和客户同意,然后区分已验证、失败和不确定的证据。

Toden社论插图:地址声明。时间推移的证据。

要点

  • 零进展手表有明确的诊断路径。
  • 权限拒绝有可用的前台或恢复路径。
  • 已验证、未验证和结果不确定仍是不同的概念。
  • Sandbox 的压缩时钟不能作为实时驻留证明。
  • 在持续激活之前,会明确说明经常性费用和退出选项。

在支持的观察窗口期内验证地址是否存在。同时配置捕获、原生报告和客户同意,然后区分已验证、失败和不确定的证据。

开始之前

  • 符合条件的地址和客户同意

  • 支持的移动位置声明

  • 持续监测需单独选择加入

请使用具有此控制权限的团队成员。更改设置前,请检查组织和环境。付款或持续注册前,请审核当前价格。屏幕截图显示的是示例工作区或公共集成参考;它们不显示真实客户或已完成的付款。

设置并使用该功能

步骤 1:从符合条件的已获取地址开始

确认客户拥有已授权的地址密码和稳定的外部参考信息。在工作流程中,启用地址智能并打开“位置”功能。选择支持的观察窗口和证据要求。一次性密码即为有效声明;多日监测需要单独报告。商业场所和仅通过浏览器访问的行程不能被视为提供居住位置证据。

Integration reference: Presence verification
打开完整尺寸图片 ↗

集成参考:存在性验证

步骤 2:配置原生应用和授权流程

使用 React Native 或 Flutter SDK 并传递稳定的用户 ID。启用后台报告时,请遵循平台后台位置设置。React Native 需要在启动时进行文档中记录的注册;Flutter 需要其清单文件和 Info.plist 声明。请说明收集的信息类型,并让用户控制权限。如果在未进行应用设置的情况下启用工作流切换,则手表将无法收集到足够的证据。

Integration reference: What your app has to do
打开完整尺寸图片 ↗

集成参考:您的应用需要做什么

步骤 3:报告应用打开和前台返回时的存在情况

当应用打开或返回前台时,请使用相同的 externalUserId 调用已记录的存在状态报告器。这支持拒绝后台权限的用户以及电池管理器限制后台权限的手机。请勿伪造坐标或替换 IP 地址。如果捕获发生在托管流程中,请在获取原生报告之前使用已记录的授权 PIN 码交接。

Integration reference: Reporting presence from your app
打开完整尺寸图片 ↗

集成参考:从您的应用报告在线状态

第四步:查看手表实际进度

开放风险情报 → 地址验证或检索 GET /api/kyc/address/presence/{externalUserId} 。检查状态、进度、观察计数和证据层级。该端点不返回 PIN 码。手表计数卡在零需要报告恢复。使用报告者的原因和 SDK 使用 presenceStatus 来区分 PIN 码缺失、权限被拒绝和位置服务被禁用的情况。

Integration reference: Showing the person where the check stands
打开完整尺寸图片 ↗

集成参考:向人展示支票所在位置

步骤 5:解释三种分辨率路径

已验证表示记录的证据符合政策要求。失败则需要存在完整性矛盾,例如位置伪造证据;缺少证据不视为失败。结论不确定表示时间窗口结束时证据不足,并不构成对客户的不利结论。请使用签名结果事件来更新您的应用程序。仅后台要求必须检查相应的政策证据,而不能仅仅依赖总天数。

Integration reference: Holding the decision on it
打开完整尺寸图片 ↗

整合参考:暂缓做出决定

步骤 6:仅在需要时启用持续循环

如需持续进行地址确认,请查看单独的“始终开启”设置、频率和年度价格。支持的频率选项为 30、60、90、180 或 365 天。请将一次性在线状态检查与年度续订服务区分开来。关闭续订将停止后续周期;正在进行的检查仍会自行完成。请查看您应用中的权限和撤销恢复设置。

Integration reference: Always-on monitoring
打开完整尺寸图片 ↗

集成参考:始终开启的监控

充分发挥这种能力

  • 使用前台报告作为受支持的备用方案,并显示实际运行的证据层。

  • 测试制造商对客户使用的 Android 设备的电池限制;仅在明确设置并向客户公开披露的情况下,才使用已记录的前台服务选项。

  • 在不泄露当事人地址或实时位置的情况下显示进度。当记录的结果发生变化时,通过您的应用程序通知您。

先测试再依赖它

运行此产品支持的沙箱或模拟器场景。如果某个工具仅供生产环境使用,请先检查访问权限和范围,然后仅使用经过审核的、获得许可的生产环境测试。文档截图或页面加载成功并不等同于端到端集成测试。

  • 零进展手表有明确的诊断路径。

  • 权限拒绝有可用的前台或恢复路径。

  • 已验证、未验证和结果不确定仍是不同的概念。

  • Sandbox 的压缩时钟不能作为实时驻留证明。

  • 在持续激活之前,会明确说明经常性费用和退出选项。

故障排除

天数为零

检查记者呼叫、已存储的 PIN 码、用户参考、服务和权限。

背景调查已停止

阅读原文 SDK 状态并使用受支持的设置恢复路径。不要一直将其标记为后台运行。

窗口期结果不明朗。

请收集缺失的证明文件或提供合适的后续行程安排。缺席并不代表地址虚假。

打开设置和集成参考

打开仪表盘工具 (在新标签页中打开)

阅读集成参考手册 (在新标签页中打开)

返回解决方案 (在新标签页中打开)。选择要激活的功能,然后按照其相应的指南进行操作。

参考来源

查尔斯·阿奇邦

关于作者

Charles Archibong

联合创始人

Charles Archibong是Toden的联合创始人。他撰写有关身份验证、金融科技以及构建可信数字服务的实际工作的文章。

打造您的产品。其余交给我们。

端到端身份验证与合规服务,遵循全球标准,为创业者提供合理定价。