Web&H5

🤖 AI Prompt

复制 AI 提示词，粘贴到 Codex、Copilot、Claude Code 等AI 编码工具，即可自动生成代码，完成 TD SDK 集成

✨点击复制 AI 提示词

一、引入 SDK
将以下代码嵌入关键业务入口页面的 head 标签内：

二、Base URL 获取
● 在控制台创建 Web 指纹的 Base URL
● 复制生成后的 Base URL，替换上面脚本中的 Base URL
三、初始化与获取 blackBox
Web 端没有单独的初始化方法，脚本加载完成后会自动采集，成功后通过 success 回调返回 blackBox。
注意：
● 不要静默失败
● Base URL、partner、回调异常这类分支，必须加日志
● 让 AI 生成代码时，明确要求输出可排查日志
window._fmOpt = {
  partner: 'your partnerCode',
  success: function(data) {
    console.log('blackbox: ', data)
  },
  timeout: 2000,
  strictMode: false,
  geolocation: false
}

四、地理位置权限
如果 geolocation=true，需要业务方自行先申请浏览器定位权限：
if (navigator.geolocation) {
  navigator.geolocation.getCurrentPosition(function () {}, function () {})
} else {
}

五、推荐接入方式
推荐在注册、登录、下单、支付等关键业务页面最早位置注入脚本，并在 blackBox 回调成功后再发起核心风控请求。
window._fmOpt = {
  partner: 'your partnerCode',
  success: function(data) {
    if (!data) {
      console.error('TD_WEB empty blackbox')
      return
    }
    submitRiskData(data)
  },
  timeout: 2000
}

六、常用配置项
partner      必传，合作方名称
channel      可选，渠道标识
success      必传，成功回调
timeout      可选，采集超时时间，单位 ms，默认 2000
strictMode   可选，true 表示返回当前降级 blackBox，false 表示优先返回历史非降级 blackBox
geolocation  可选，是否开启地理位置采集

七、验证是否成功
success 回调被触发并返回 blackBox，即表示接入成功。
● 正常情况下可直接使用返回值
● 超过超时时间未完成全部流程时，可能返回降级 blackBox
八、获取 SDK 版本号
运行时代码：
window._fmOpt.sdkVersion

当前文档对应 JS 版本标识：
TrustDeviceJs Pro v3.8.11

初始化 SDK

将以下代码嵌入关键业务入口页面的 head 标签内

<script type="text/javascript">
	(function(){
		window._fmOpt = {
			partner: 'your partnerCode',
			success: function(data) {
				console.log('blackBox: ', data)
			}
		};
		var fm = document.createElement('script'); 
    fm.type = 'text/javascript'; fm.async = true;
		fm.src = 'Base URL' + '?t=' + (new Date().getTime()/3600000).toFixed(0);
    var s = document.getElementsByTagName('script')[0]; 
    s.parentNode.insertBefore(fm, s);
	})();
</script>

Base URL

1.创建Base URL

2.复制Base URL

window._fmOpt 配置参数

参数	类型	描述	备注	示例	是否必传	移除字段
partner	String	合作方名称	由TD分配，请勿随意更改（只能字母、数字、下划线组合）	demo	是
channel	String	渠道标识	由TD分配，请勿随意更改（只能字母、数字、下划线组合）	demo_web	否
success	Function	成功回调	成功获取到blackBox后，会调用传入的回调	function(data){ console.log('blackBox:',data) }	是
timeout	Integer	采集超时时间	单位为ms，默认2000ms。超过指定时间未完成所有流程，则会获取到降级blackBox	2000	否
strictMode	Boolean	严格模式	true：降级时返回当前降级的blackBox false：降级时返回缓存的上一次非降级的blackBox （默认）	false	否
geolocation	Boolean	开启地理位置采集	true：开启（开启后，需客户自己获取权限，获取权限代码如下） false：不开启（默认）	false	否	latitude、longitude

geolocation配置为true时需客户主动获取地理位置权限

if (navigator.geolocation) {
  // 第一次执行会触发是否授权的弹框
  navigator.geolocation.getCurrentPosition(function () {}, function () {});
} else {
  // 当前环境不支持获取地理位置信息
}

同步获取blackBox的方法

同步方法可能增加降级 blackBox 的生成概率，请结合业务场景谨慎使用

if (window._fmOpt && window._fmOpt.getinfo) {
  // 同步获取blackBox
  var your_blackBox = window._fmOpt.getinfo()
} else {
  // JSSDK未加载完成
}

状态检查

SDK上报数据成功，返回的结果长度为26位字符串。如: gWPHA1780038520GyQHv1YhD61。
异常情况下，返回的结果长度可能达到5000字符，详情可查看正常blackBox和降级blackBox的差异

获取SDK版本号

JS源文件获取

/**
 * TrustDeviceJs Pro v4.2.2 - Copyright (c) TrustDeviceJs, Inc, 2026 (https://www.trustdecision.com/solutions/trustdevice)
*/

运行时代码获取

window._fmOpt.sdkVersion