Translation disclaimer

Documentation is written in English and subsequently translated. This page, therefore, might not have the most up-to-date content. If any questions arise relating to the accuracy of the translated content, please refer to the English version of the page.

Menu

注释：该 API 仅用于预览用途并会随时更改。

设备数据收集

当与订单和交易详细信息相结合时，设备数据（IP 地址、设备 Id、地理位置信息等）会是欺诈的重要标志，或通过 GeoIP 查找创建基于位置的手动规则。利用具有 Access Exemptions 功能的设备数据需要两个步骤。第一步是收集设备数据。第二步是提交将使用设备数据进行评估的评估。以下所述为 Web (JS) 的第一步。

ThreatMetrix JS

网站用 ThreatMetrix JS 库。它利用 ThreatMetrix 平台实时检测来自浏览器的欺诈和安全漏洞。

实施概述

  1. 创建包含以下 "ThreatMetrix JavaScript V4" 数据的 JavaScript 文件。文件名应作匿名处理，例如 asdfghjkl.js

  2. 将功能 threatmetrix. 配置文件（来自文件 asdfghjkl.js）重命名为匿名，e.g. awddc.prfl

  3. 在会收集设备数据的网页上，将以下内容（或类似内容）放在标题部分
    <script type="text/javascript" src="path/to/asdfghjkl.js"></script>

  4. 使用以下（或类似）
    <script type="text/javascript">awddc.prfl （"PROFILING_DOMAIN"、"ORGANISATION_ID"、sessionId）；</script>从网页中调用设备分析功能 (awddc.prfl)

注释：请参见下方所述功能参数的“所需的详情”部分

所需的详情

若要调用设备数据函数，您需要以下详情：

占位符描述
ORGANISATION_ID
  • 对于测试用途：afevfjm6
  • 对于实时用途：dzppsd1h
PROFILING_DOMAIN
  • 对于测试用途：ddc-test.worldpay.com
  • 对于实时用途：ddc.worldpay.com
sessionId您必须为页面视图生成独特的值，以表示该具体设备数据集合。

注释：有效的 sessionId 长度为 30 ~ 128 个字符，只能由大小写英文字母 (a-z, A-Z)、数字 (0-9)、连字符 (-) 或下划线 (_) 组成。为了避免错误匹配，我们建议使用 UUID。

示例 sessionId 生成

您必须在评估请求中提交 sessionId，以便将设备数据作为风险评估的一部分进行应用。建议在后端作为页面生成的一部分来生成。此外，您还可以通过 JS 来生成它，然后提交以便其可用于后端。

Copied!
function create_uuid() {
  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {
   var r = Math.random() * 16 | 0,
     v = c == 'x' ? r : (r & 0x3 | 0x8);
    return v.toString(16);
 });

调用 Threatmetrix 函数

Copied!
...
var sessionid = create_uuid(); // function to create UUID
awddc.prfl ("PROFILING_DOMAIN", "ORGANISATION_ID", sessionid); // call Threatmetrix
...

将设备数据与评估关联

在发送豁免评估请求时，将 sessionId 纳入 deviceData.collectionReference

后续步骤

评估