Adyen Dropin组件：如何触发并测试3DS验证挑战流程？

问题场景 #

已配置Adyen Dropin组件完成正常支付流程，普通测试卡支付成功，但使用已注册3DS的测试卡时：

• 无任何用户端交互
• 网络面板收到IdentifyShopper响应：

{
  "action": {
    "paymentData": "Ab02...",
    "paymentMethodType": "scheme",
    "type": "threeDS2",
    "authorisationToken": "Ab02...",
    "subtype": "fingerprint",
    "token": "eyJ0..."
  },
  "resultCode": "IdentifyShopper",
  "sessionData": "Ab02b4c0!..."
}

• SDK日志显示已执行3DS指纹验证：

[
    {
        "timestamp": "1741366789043",
        "component": "threeDS2fingerprint",
        "id": "9e46...",
        "type": "action",
        "message": "threeDS2fingerprint action was handled by the SDK",
        "subType": "threeDS2"
    }
]

• 未触发任何回调函数

排查方向 #

• 检查Dropin初始化的3DS配置
  确认初始化时是否正确启用3DS2组件，比如在配置对象中包含threeDS2相关参数（如challengeWindowSize），同时验证clientKey与后台API环境（测试/生产）完全匹配。

• 验证IdentifyShopper响应的传递与处理
  确保后台完整返回IdentifyShopper的所有字段（包括action和sessionData），且前端将完整响应传递给Dropin的handleAction方法；检查调用handleAction时是否存在异步逻辑错误，比如未正确处理Promise或遗漏错误捕获。

• 排查指纹验证后的会话与请求状态
  查看网络面板，确认指纹验证完成后是否发送了/payments/details请求；检查sessionData在整个流程中是否完整，无篡改或截断。

• 检查回调函数的绑定与执行
  确认onAdditionalDetails、onError等回调已正确绑定到Dropin实例，未被覆盖或未定义；在回调内添加日志输出，排查是否有内部语法错误或异常导致执行中断。

• 验证测试环境与浏览器兼容性
  使用Adyen官方指定的3DS测试卡（如4917 6100 0000 0000）；检查浏览器是否禁用第三方Cookie（临时启用测试），以及是否支持3DS2的安全特性。

• 开启SDK调试模式排查隐藏错误
  初始化Dropin时添加debug: true配置，查看控制台的详细日志；检查浏览器控制台的Warnings/Errors标签，排查是否有3DS组件相关的资源加载或脚本错误。

内容的提问来源于stack exchange，提问作者Dan Cryer