开始使用

Antom Shield 通过接口数据检测和阻止风险交易，因此您的集成方式和数据质量将直接影响风险评估的效果。本文将提供集成方式的参考和数据质量的标准。

集成方式

Antom Shield 和 Antom Shield Premium 已经自动集成在 Antom 卡收单产品中。关于如何集成卡收单产品，请参阅银行卡支付。当您需要应用 Antom Shield 和 Antom Shield Premium 产品时，以下为 Antom 卡收单产品的集成方式及相关建议。

SDK 集成

建议您优先使用 SDK 来集成 Antom 卡收单产品，这样能够确保 Antom Shield 功能的最佳效果。当您使用 SDK 来集成 Antom 卡收单产品时，无需额外集成安全 SDK。请参阅银行卡支付查看卡收单产品 SDK 集成步骤。

API 集成

当您选择使用 API 集成 Antom 卡收单产品时，建议单独集成安全 SDK，以确保能够有效识别终端设备的风险信号。具体 API 集成步骤如下：

请根据您的终端类型，通过以下步骤提前引入安全 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)

数据质量

Antom Shield

当您需要使用 Antom Shield 提供的名单、规则及风险评分能力时，请在交易中检查 order.buyer.referenceBuyerId 和 env.clientIp 字段传输的完整性。此外，请传输以下关键字段，当字段缺失或有误的情况下，与字段相关的名单或涉及变量的规则将无效，完整及准确的交易数据可有效提高风险评分的准确性。

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

Antom Shield 将收集部分设备及交易数据用于欺诈识别，提升支付安全度及服务质量。您可在阅读并同意 Antom Dashboard 上风控服务相关条款后开始使用 Antom Shield。如您需要希望取消 Antom Shield 服务或删除相关数据，请联系您的客户经理。

Antom Shield Premium

启用 Antom Shield Premium 服务时，请确保传输接口文档中标注风控需要的字段的准确性，以保证智能风控决策的有效性。您所提供的数据量与数据质量直接关系到风控决策的精准度；数据越多、质量越高，相应的风险评估与管理决策将更加准确和可靠。更多详情，请参阅 Antom Shield Premium 专家决策服务介绍，字段要求请参阅 Antom 接口。

注意：由于法规限制，激活特定区域卡的商家可能无法使用 Antom Shield 和 Antom Shield Premium。请联系您的 Antom 客户经理了解更多信息。