优化风险评估质量

Antom Shield 通过实时分析支付接口数据，识别潜在欺诈交易，帮助您有效降低相关风险。该服务的机器学习模型依赖高质量的交易数据进行训练，您提供的支付请求数据越丰富、越准确，欺诈预防的效果则越显著。Antom 承诺所有相关数据仅用于欺诈检测与风险防控，不会用于任何其他目的。

集成方式与数据质量将直接影响风险评估的准确性。为达到最佳防护效果，我们建议您：

• 在发起支付请求时尽可能提交完整的字段信息；
• 为买家端支付行为集成相应的安全组件，包括 Risk.js（Web 端）或 Risk Android/iOS SDK（移动端），具体请参考卡支付产品与安全 SDK 集成方案。

建议传输数据

为有效启用 Antom Shield 的名单、规则及风险评分功能，请务必准确传输以下关键字段。任何字段的缺失或错误，将直接导致其关联的名单匹配失败或规则判定失效。完整且准确的数据是确保风险评分准确性的基础。

当您使用 API 集成 Antom 卡支付产品并已集成安全 SDK 时，Antom 也会将安全 SDK 收集到的信息用于 Antom Shield 规则配置及风险分判断。

为有效识别欺诈行为并提升支付安全性与服务质量，Antom Shield 会收集部分设备及交易相关数据。如您希望取消 Antom Shield 服务或删除相关数据，请联系您的客户经理进行处理。

Antom Shield Premium 提供由 Antom 风控专家团队主导的全托管式欺诈风险管理服务。启用该服务后，请务必确保传输接口文档中标记为风控相关的字段准确无误，以保障智能风控决策的有效执行。您所提供的数据数量与质量将直接影响风险判断的精准度，数据越完整、质量越高，风险评估与管理决策的结果将越可靠。如需了解更多服务详情，请参阅 Antom Shield Premium 专家决策服务介绍，字段要求请参阅 pay（单笔支付）。

集成安全 SDK

安全 SDK 是由 Antom 提供的终端设备识别组件，用于采集并生成设备标识信息，以支持交易与账户的风险检测。当您通过 API 集成 Antom 卡支付产品时，需要同时集成安全 SDK，使系统能够精准识别用户终端设备特征并评估其风险信号，从而保障支付交易的安全性与合规性。

安全 SDK 集成流程

以下为集成流程示意图：

安全 SDK 集成步骤

请根据您的终端类型，通过以下步骤提前引入安全 SDK 包：

// 使用 CDN 资源引入 SDK 包：
<script src="https://sdk.marmot-cloud.com/package/antom-web-security/1.1.1/dist/umd/ams-security.min.js"></script>

// 通过 npm 引入 SDK 包：
npm install ams-security

import { AMSSecurity } from 'ams-security'

/**
 * 判断 AMSSecuritySdk 是否已准备好
 * 如果已准备好，则调用 initAPSecurity 方法
 * 如果未准备好，则监听 onAMSSecurityReady 事件，当事件触发时，再次调用 initAPSecurity 方法
 */
if(window.APSecuritySdk) {
  console.log('AMSSecuritySdk 已准备好');
  initAPSecurity();
} else {
  console.log('AMSSecuritySdk 未准备好');
  window.onAPSecurityReady = function() {
    console.log('onAMSSecurityReady 已触发');
    initAPSecurity();
  };
}

/**
 * 初始化 AMSSecuritySdk
 * @param {string} scence - 场景: CARD
 * @param {object} options - 配置项
 * @param {string} options.region - 区域: SG/US/DE
 */
function initAPSecurity() {
  AMSSecurity.init("CARD", { region: "SG" })
}

/**
 * 初始化 AMSSecuritySdk
 * @param {string} scence - 场景: CARD
 * @param {object} options - 配置项
 * @param {string} options.region - 区域: SG/US/DE
 */
AMSSecurity.initToken("CARD", {}, (success: Boolean, tokenResult: any, msg: String) => {
    console.log("[Demo] initToken result success", success)
    console.log("[Demo] initToken result tokenResult", JSON.stringify(tokenResult))
    console.log("[Demo] initToken result msg", msg)
  });

AMSSecurity.getTokenResult("CARD", (tokenResult: TokenResult) => {
    console.log("[Demo] getDeviceToken tokenResult", JSON.stringify(tokenResult))
  });

// 安全 SDK 环境设置
// scene: CARD
// region: SG、US、DE
public static func initSecurity(_ scene: String, region: String)

// deviceToken 初始化
// scene: CARD
public static func initToken(_ scene: String, callback: @escaping (AMSSecurityTokenResult?, String?) -> Void)

// apdidToken 同步获取
// scene: CARD
public static func getTokenResult(_ scene: String) -> AMSSecurityTokenResult?

// 安全 SDK环境设置
// scene: CARD
// region: SG、US、DE
public static void initSecurity(Context context, String scene, String region)

// deviceToken 初始化
// scene: CARD
public static void initToken(String scene, final InitResultListener listener)

// deviceToken 同步获取
// scene: CARD
public static TokenResult getTokenResult(String scene)