SDK 和设备数据初始化
发卡机构利用设备数据收集 (DDC) 来采集客户设备的指纹。
这些数据会与
设备数据初始化
该请求会创建用作 SDK 初始化和设备数据收集一部分的 JSON Web Token (JWT)。在 Web 集成捕获浏览器详情时，应用程序 SDK 会收集有关用户移动设备的信息。
POST 您的设备数据初始化请求至 3ds:deviceDataInitialize 操作链接。
注释：与 Web 集成不同，您不需要出于设备数据收集目的而请求和使用 BIN。如果您的集成同时涉及 Web 和 Android/iOS，为了简单起见，您可以使用与 Web 相同的
重要信息：您只应从后端系统请求设备数据初始化 API。您不得使用 Access 凭证直接从移动应用程序中调用。
设备数据初始化示例请求
注释：对于 Android/iOS SDK，您必须使用 v3 版的 API
POST https://try.access.worldpay.com/verifications/customers/3ds/deviceDataInitialization
{
"transactionReference": "Memory265-13/08/1876",
"merchant": {
"entity": "default"
}
}| 参数 | 必需 | 描述 |
|---|---|---|
transactionReference | 独特的身份验证参考号。例如，电子商务订单代码。 在所有 3 个潜在请求类型（deviceDataInitialization、authentication、verification）中使用相同的 transactionReference。 | |
merchant.entity | 作为加入流程的一部分而创建，用于在 Access Worldpay 中发送请求。 |
设备数据初始化响应
最佳实践：Access Worldpay 在服务响应的头文件中返回WP-CorrelationId。我们强烈建议您将此记录下来。我们使用WP-CorrelationId检查单个服务请求。
{
"outcome": "initialized",
"transactionReference": "Memory265-13/08/1876",
"deviceDataCollection": {
"jwt": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJPcmdVbml0SWQiOiJPcmdVbml0IiwiaXNzIjoiYXBpSWQiLCJleHAiOjE1NjI5MjMzNDYsImlhdCI6MTU2MjkyMzQwNiwianRpIjoiYTAzMWVhOGEtN2E0Zi00YTQwLWI1NjMtOTUzMzYzMzVhZGNmIn0.0IK74OIXBxFsxqeOURJz1TFnz14ZTbFJTdTWo9cHUJQ",
"url": "https://ddcUrl.example.com"
},
"_links": {
"3ds:authenticate": {
"href": "https://try.access.worldpay.com/verifications/customers/3ds/authentication"
},
"curies": [{
"href": "https://try.access.worldpay.com/rels/verifications/customers/3ds/{rel}",
"templated": true,
"name": "3ds"
}]
}
}| 参数 | 描述 |
|---|---|
deviceDataCollection.jwt | 包含设备数据收集所需的其他详情的数字签名 Token。Try 和 Production 版都将在 10 分钟后到期。 |
deviceDataCollection.url | 设备数据收集表格上的 POST 操作。用于重定向至发卡机构设备数据收集页面。仅用于 Web 集成 |
注释：如果出现错误，您可以在我们的
SDK 初始化
Access 3DS API 会针对最新的 Cardinal SDK 定期进行测试。当前已测试的 Cardinal SDK 版本：
- Android：
v2.2.6 - iOS：
v2.2.5
设置 Cardinal SDK
初始调用 Cardinal 和响应
这样，您将收到用于consumerSessionId
后续步骤
