如何测试和排查与 Toden 的集成问题
Charles Archibong, 联合创始人
测试完整的集成过程，包括故障和恢复。选择您使用的 API 系列所支持的测试用例，然后检查 Toden 的记录和您的应用程序的行为。
要点
- 所有决策分支都到达了其预期的应用路径。
- 丢失的回复和重复的事件不会产生重复的效果。
- 待处理和不可用状态仍然是不同的。
- 灯具仍保留明确的标签。
- 仅针对生产环节的索赔需要提供实际证据。
测试完整的集成方案，包括故障和恢复过程。选择受支持的测试夹具。 API 然后检查你使用的家庭，两者 Toden 的记录和您的应用程序的行为。
开始之前
受支持的沙箱场景或已标记的样本
使用正确的端点族和 SDK 版本
请使用具有此控制权限的团队成员。更改设置前，请检查组织和环境。付款或持续注册前，请审核当前价格。屏幕截图显示的是示例工作区或公共集成参考；它们不显示真实客户或已完成的付款。
设置并使用该功能
步骤 1：匹配产品、主机和凭据
选择沙盒并录制 API 您正在测试的系列。身份验证使用已记录的 /api/kyc 主机和测试密钥。风险智能使用其沙盒 /api/v1 主机和密钥。身份中心有其自身的 /api/identity 合约。请勿在不同系列之间移动请求字段，也不要暗示每个沙盒请求都是免费的。显式风险智能场景不计费；普通请求可以使用已配置的定价。
集成参考：沙盒
步骤 2：选择受支持的验证场景
打开沙盒和测试 ID指南，然后选择符合国家/地区和证件类型的 ID。例如，尼日利亚的 ID。 BVN 以 01 结尾的验证通过，以 04 结尾的验证则会产生自拍不匹配。仅文档验证结果需要文档 ID。请使用已发布的方案或支持的覆盖方案；沙盒验证合约拒绝使用真实身份号码。
集成参考：场景参考
步骤 3：使用模拟器进行受支持的风险旅程
打开开发者 →沙盒模拟器。选择一个受支持的场景并检查其是否符合要求。已锁定或需要设置的场景必须满足其显示的先决条件；请勿移除任何限制条件来运行它们。旅行规则装置需要兼容的、单独发布的策略。运行确定性场景证明其受控处理，而非实际的提供商连接或机构交换。
集成参考：设置沙盒旅行规则
步骤 4：独立测试签名接收器
创建沙盒 Webhook 端点，并使用测试功能模拟受支持的事件。验证签名是否与原始字节匹配，并保存其逻辑 ID。测试重发、无效签名、签名过期和接收方故障。生成的示例标识符仅用于演示其形状，不可重用。 API 资源用于后续的检索调用。
集成参考：目录驱动型夹具
第五步：练习不确定性和排序
模拟请求被接受后响应丢失的情况，然后在合约支持的情况下，使用原始引用和幂等键重试完全相同的操作。延迟或重新排序已接受的通知，并协调当前状态。将待处理和不可用的结果与拒绝的结果分开测试。检查 Toden 记录并保存应用程序的持久状态，以防重复或访问更改错误。
集成参考：排序断言
步骤 6：保留具体的生产准备记录
记录测试场景、预期决策、实际决策、后端操作和恢复证据。检查支持情况。 SDK 版本、权限恢复和代表性设备。仅在满足业务和功能需求后，才设置独立的生产工作流、密钥和接收器。移除仅限沙盒环境的场景字段。本地测试或示例的绿色评分并不能证明真实客户的行为。
集成参考：上线检查清单
充分发挥这种能力
保持 fixtures 与公共合约的形式一致，以便您的测试套件能够捕获字段和版本更改。
对需要等待筛选、关键人员或出席的工作流程进行延迟最终决策测试。
对于运营故障，应该提供专门的客户安全消息和内部恢复路径，而不是要求申请人修复服务中断。
先测试再依赖它
运行此产品支持的沙箱或模拟器场景。如果某个工具仅供生产环境使用，请先检查访问权限和范围，然后仅使用经过审核的、获得许可的生产环境测试。文档截图或页面加载成功并不等同于端到端集成测试。
所有决策分支都到达了其预期的应用路径。
丢失的回复和重复的事件不会产生重复的效果。
待处理和不可用状态仍然是不同的。
灯具仍保留明确的标签。
仅针对生产环节的索赔需要提供实际证据。
故障排除
我的真实身份信息在沙盒测试中被拒绝了。
请使用已发布的测试 ID。沙盒验证不会验证真实身份号码。
模拟器场景已锁定
完成其公布的政策或受控装置先决条件。
无法检索示例资源。
目录示例仅用于展示形状；它们的 ID 不是实际存储的资源。
打开设置和集成参考
返回解决方案 （在新标签页中打开）。选择要激活的功能，然后按照其相应的指南进行操作。
参考来源
