全球用户画像

API 方式

Base URL

API

URL请求方式Content-Type输出格式字符集
api-base-url?partner_code=xxx&partner_key=xxxPOSTapplication/jsonJSONUTF-8
认证参数
字段类型含义建议备注
partner_codeString合作方标识必须由 TD 分配
partner_keyString合作方密钥必须由 TD 分配

请求参数

字段名称字段类型是否必填字段描述备注
transaction_timeString是交易发生时间UTC标准时间,YYYYMMDDHHMMSS,如20260416134043
transaction_amountString是交易金额以该货币的最小单位表示。如果购买金额为 123.45 美元,则该字段的值应为 12345
transaction_currencyexponentString是购买币种的小数位数如果购买金额为 123.45 美元,则该字段的值为 2
transaction_currencyString是交易金额所使用的币种采用 ISO-4217 货币代码表示,如840
merchant_nameString是商户名称
merchant_countrycodeString是商户所属国家编码所属国家/地区的 ISO-3166 国家代码,如840或US
mccString是商户类别代码
ipString否IP 地址支持 IPV4 和 IPV6
billing_nameString否账单姓名必须<=45字符
billing_phone_country_idString否账单电话国家编码如86
billing_phoneString否账单电话
billing_emailString否账单邮箱
billing_address_country_idString否账单地址国家编码所属国家/地区的 ISO-3166 国家代码,如840或US
billing_address_state_idString否账单地址州编码
billing_address_postal_idString否账单地址邮政编码
billing_address_cityString否账单地址城市
billing_address_street1String否账单邮寄地址1必须<=50字符
billing_address_street2String否账单邮寄地址2必须<=50字符
shipping_nameString否货运收件人姓名必须<=100字符
shipping_phone_country_idString否货运收件人电话国家编码如86
shipping_phoneString否货运收件人电话
shipping_emailString否货运收件人邮箱
shipping_address_country_idString否货运地址国家编码所属国家/地区的 ISO-3166 国家代码,如840或US
shipping_address_state_idString否货运地址州编码
shipping_address_postal_idString否货运地址邮政编码
shipping_address_cityString否货运地址城市
shipping_address_street1String否货运邮寄地址1必须<=50字符
shipping_address_street2String否货运邮寄地址2必须<=50字符
user_agentString否设备的 user-agent 字符串user-agent 必须代表服务消费方的 HTTP 客户端,并包含发起该请求的软件详细信息
timezoneString否消费者设备的时区,该时区必须表示为基于当前主机系统设置、相对于 UTC 的时区偏移分钟数
screen_widthString否消费者设备的屏幕宽度
screen_heightString否消费者设备的屏幕高度
languageString否消费者设备的语言。该语言必须是一个按照 BCP 47 定义的语言版本字符串
colordepthString否设备屏幕的颜色深度值
modelString否移动设备制造商和型号Android:返回移动设备的制造商和型号,例如:samsung SM-G960U1
iOS:设备型号,例如:iPhone10,4,注意:由于所有 iOS 设备的制造商均为 Apple,因此不包含制造商信息
major_os_versionString否主操作系统版本
minor_os_versionString否次要操作系统版本
account_numberString否交易账户号
card_last4String否交易卡号后4位
card_expirydateString否交易卡有效期格式为“YYMM”
card_binString否交易卡bin
acquirer_merchant_idString否由收单机构分配的、该交易所归属的商户 ID
acquirer_binString否收单机构的 BIN(银行识别号)
work_phone_country_idString否工作电话国家编码如86
work_phoneString否工作电话
extraString否扩展字段,Json 字符串格式可为空

请求示例

{
  "transaction_time": "20260416134043",
  "ip": "23.129.64.214",
  "billing_name": "xxxxxx",
  "billing_phone_country_id": "1",
  "billing_phone": "3143978691",
  "billing_email": "[email protected]",
  "billing_address_country_id": "840",
  "billing_address_state_id": "TX",
  "billing_address_postal_id": "63124",
  "billing_address_city": "Houston",
  "billing_address_street1": "912 Uclan Dr",
  "shipping_name": "xxxxx",
  "shipping_phone_country_id": "1",
  "shipping_phone": "3143978691",
  "shipping_email": "[email protected]",
  "shipping_address_country_id": "840",
  "shipping_address_state_id": "TX",
  "shipping_address_postal_id": "63124",
  "shipping_address_city": "Houston",
  "shipping_address_street1": "912 Uclan Dr",
  "extra": "",
  "transaction_amount": "12500",
  "transaction_currencyexponent": "2",
  "transaction_currency": "840",
  "merchant_name": "Acme Inc",
  "merchant_countrycode": "US",
  "mcc": "5411",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/147.0.0.0 Safari/537.36",
  "timezone": "600",
  "screen_width": "1512",
  "screen_height": "982",
  "language": "en-GB",
  "colordepth": "30",
  "model": "iPhone10.4",
  "major_os_version": "12",
  "minor_os_version": "0",
  "account_number": "4111111111111111",
  "card_last4": "1111",
  "card_expirydate": "2311",
  "card_bin": "411111",
  "acquirer_merchant_id": "ACME",
  "acquirer_bin": "444444",
  "work_phone_country_id": "1",
  "work_phone": "3143978691"
}

响应参数

字段名称字段类型字段描述备注
codeIntegerAPI 状态码
messageString状态信息在 API 异常状态下会输出具体的异常原因
sequence_idString响应唯一码用于跟踪每次请求记录的唯一标识
risk_scoreInteger综合风险分,范围 0 - 100
risk_score_reason_codeString综合风险原因含义详见附录1
device_risk_scoreInteger设备风险分,范围 0 - 100
ip_risk_scoreIntegerIP 风险分,范围 0 - 100
ip_carrierStringIP运营商
ip_connection_typeStringIP 连接类型cable-dsl:有线
corporate:公司
cellular:蜂窝
dialup:拨号
ip_geolocation_cityStringIP地址所属城市
ip_geolocation_country_codeStringIP 地址所属国家编码
ip_geolocation_stateStringIP地址所属州
ip_last_seen_daysIntegerIP 地址最近一次出现至今的天数
ip_proxyBoolean是否代理IP
ip_proxy_riskclassStringIP代理类型风险程度
billing_address_first_seen_daysInteger账单邮寄地址首次出现至今的天数
billing_address_last_seen_daysInteger账单邮寄地址最后出现至今的天数
billing_address_shipping_address_relationshipString账单地址与货运地址的关系match:匹配
city_match:城市匹配
seen_together:一起出现过
seen_with_others:账单地址与其他购物地址一起出现过
no_relationship:没有关系
null:地址无效或者不详细
billing_address_to_nameString账单邮寄地址与账单姓名是否匹配not-found:无记录
match:匹配
no-match:不匹配
billing_address_validity_levelString账单邮寄地址合法等级missing_address:地址缺失
invalid:非法
valid_to_country:国家合法
valid_to_city:国家、城市合法
valid_to_street:国家、城市、街道合法
valid_to_house_number:国家、城市、街道和门牌号合法
valid_to_house_number_missing_apt:国家、城市、街道和门牌号码合法,但 apartment 不合法
valid:合法
billing_email_disposableBoolean账单邮箱是否为一次性邮箱域名
billing_email_domain_creation_dateString电子邮件域的创建日期
billing_email_first_seen_daysInteger账单邮箱首次出现至今的天数
billing_email_last_seen_daysInteger账单邮箱最后出现至今的天数
billing_email_risk_scoreInteger邮箱风险分,范围0-100
billing_email_to_nameString账单邮箱与账单姓名是否匹配not-found:无记录
match:匹配
no-match:不匹配
billing_email_validBoolean账单邮箱是否合法true:合法
false:不合法
billing_email_velocityInteger账单邮箱在过去 180 天内被观测到的次数
billing_ip_address_distanceInteger账单邮寄地址与 IP 地址的距离(英里)
billing_phone_carrierString账单电话运营公司
billing_phone_to_nameString账单电话与账单姓名是否匹配not-found:无记录
match:匹配
no-match:不匹配
billing_phone_typeString账单电话类型landline:传统座机
fixed-voip:固定 voip,互联网电话
non-fixed-voip:非固定 voip (虚拟号码)
mobile:手机
voicemail:语音信箱
toll-free:免费电话,被叫方付费
premium:付费电话,呼叫方付费
other:其他
billing_phone_validBoolean账单电话是否合法true:合法
false:不合法
shipping_address_first_seen_daysInteger货运邮寄地址首次出现至今的天数
shipping_address_last_seen_daysInteger货运邮寄地址最后出现至今的天数
shipping_address_to_nameString货运邮寄地址与货运收件人姓名是否匹配not-found:无记录
match:匹配
no-match:不匹配
shipping_address_validity_levelString货运邮寄地址合法等级missing_address:地址缺失
invalid:非法
valid_to_country:国家合法
valid_to_city:国家、城市合法
valid_to_street:国家、城市、街道合法
valid_to_house_number:国家、城市、街道和门牌号合法
valid_to_house_number_missing_apt:国家、城市、街道和门牌号码合法,但 apartment 不合法
valid:合法
shipping_ip_address_distanceInteger货运邮寄地址与 IP 地址的距离(英里)
shipping_phone_carrierString货运电话运营公司
shipping_phone_to_nameString货运电话与姓名是否匹配not-found:无记录
match:匹配
no-match:不匹配
shipping_phone_typeString货运电话类型landline:传统座机
fixed-voip:固定 voip,互联网电话
non-fixed-voip:非固定 voip (虚拟号码)
mobile:手机
voicemail:语音信箱
toll-free:免费电话,被叫方付费
premium:付费电话,呼叫方付费
other:其他
shipping_phone_validBoolean货运收件人电话是否合法true:合法
false:不合法
browserString浏览器名称
device_email_payment_first_seen_daysInteger设备 邮箱 支付信息 - 首次出现天数
device_ip_email_first_seen_daysInteger设备 IP 邮箱 - 首次出现天数
device_ip_first_seen_daysInteger设备 IP - 首次出现天数
device_ip_payment_first_seen_daysInteger设备 IP 支付信息 - 首次出现天数
device_ip_tz_differenceString设备浏览器时区与 IP 时区差异设备浏览器时区与 IP 时区差异
Null: 无效输入
0 – 低风险
1 - 中风险
2+ – 高风险
device_typeString设备类型
platformString设备平台名称
card_holder_name_first_seen_daysInteger支付卡持卡人姓名首次出现天数
card_holder_name_velocityInteger在过去 90 天内,支付卡与持卡人姓名这一组合在网络中被观察到的次数
merchant_category_ratioString购买金额相对于同类别其他相似商户的购买金额中位数的比率,比率越高,风险越高
work_phone_carrierString工作电话运营商
work_phone_to_nameString工作电话与姓名是否匹配not-found:无记录
match:匹配
no-match:不匹配
work_phone_typeString工作电话类型landline:传统座机
fixed-voip:固定voip,互联网电话
non-fixed-voip:非固定 voip (虚拟号码)
mobile:手机
voicemail:语音信箱
toll-free:免费电话,被叫方付费
premium:付费电话,呼叫方付费
other:其他
work_phone_validBoolean工作电话是否合法true:合法
false:不合法

API 状态码

code含义
200成功
301未购买此服务
302流量已被禁用
303流量不足
304服务已过期
305日流量已封顶
9600系统错误
9606参数非法

响应示例

{
  "code": 200,
  "message": "",
  "sequence_id": "1648777165770866F82AC7F326307055",
  "risk_score": 77,
  "risk_score_reason_code": "JB",
  "device_risk_score": 98,
  "ip_risk_score": 86,
  "ip_last_seen_days": 0,
  "ip_geolocation_country_code": "US",
  "ip_geolocation_city": "Colorado Springs",
  "ip_carrier": "xxxxxxx",
  "ip_geolocation_state": "Colorado",
  "ip_proxy": true,
  "ip_proxy_riskclass": "high",
  "ip_connection_type": "cable-dsl",
  "billing_email_risk_score": 89,
  "billing_email_valid": true,
  "billing_email_velocity": 9,
  "billing_email_disposable": false,
  "billing_email_to_name": "match",
  "billing_email_domain_creation_date": "1995-08-13",
  "billing_email_first_seen_days": 6979,
  "billing_email_last_seen_days": 0,
  "billing_phone_valid": true,
  "billing_phone_type": "premium",
  "billing_phone_carrier": "xxxxxx",
  "billing_phone_to_name": "no-match",
  "billing_ip_address_distance": 954,
  "billing_address_validity_level": "valid",
  "billing_address_to_name": "no-match",
  "billing_address_first_seen_days": 1437,
  "billing_address_last_seen_days": 0,
  "billing_address_shipping_address_relationship": "match",
  "shipping_phone_valid": true,
  "shipping_ip_address_distance": 954,
  "shipping_address_validity_level": "valid",
  "shipping_address_to_name": "no-match",
  "shipping_address_first_seen_days": 1011,
  "shipping_address_last_seen_days": 0,
  "shipping_phone_to_name": "no-match",
  "shipping_phone_type": "premium",
  "shipping_phone_carrier": "xxxxx",
  "device_type": "Mac",
  "browser": "Chrome",
  "platform": "Mac OS X",
  "device_ip_tz_difference": 840,
  "device_ip_first_seen_days": 0,
  "device_ip_payment_first_seen_days": 0,
  "device_ip_email_first_seen_days": 0,
  "device_email_payment_first_seen_days": 0,
  "work_phone_to_name": "no-match",
  "work_phone_valid": true,
  "work_phone_type": "premium",
  "work_phone_carrier": "xxxxx",
  "card_holder_name_first_seen_days": 0,
  "card_holder_name_velocity": 0,
  "merchant_category_ratio": 2.6
}

附录1

Reason code含义
AA消费者身份可疑
AB与邮箱相关的风险升高
AC与邮箱和IP相关的风险升高
AD与邮箱和地址相关的风险升高
AE与邮箱和电话相关的风险升高
AF与邮箱和姓名相关的风险升高
AG与IP相关的风险升高
AH与IP和电话相关的风险升高
AI与IP和地址相关的风险升高
AJ与IP和姓名相关的风险升高
AK与地址相关的风险升高
AL与地址和电话相关的风险升高
AM与地址和姓名相关的风险升高
AN与姓名相关的风险升高
AO与姓名和电话相关的风险升高
AP与电话相关的风险升高
AQ与设备和邮箱相关的风险升高
AR与设备和IP相关的风险升高
AS与地址和设备相关的风险升高
AT与设备和姓名相关的风险升高
AU与设备和电话相关的风险升高
AV与邮箱和支付信息相关的风险升高
AW与IP和支付信息相关的风险升高
AX与地址和支付信息相关的风险升高
AY与姓名和支付信息相关的风险升高
AZ与支付信息和电话相关的风险升高
JA新消费者或信息不足
JB与邮箱相关的中等风险信号
JC与地址相关的中等风险信号
JD与电话相关的中等风险信号
JE与姓名相关的中等风险信号
JF与IP相关的中等风险信号
RA在所有要素上均已建立消费者可信度
RB邮箱可信度已建立
RC邮箱和IP可信度已建立
RD邮箱和地址可信度已建立
RE邮箱和电话可信度已建立
RF邮箱和姓名可信度已建立
RGIP可信度已建立
RHIP和电话可信度已建立
RIIP和地址可信度已建立
RJIP和姓名可信度已建立
RK地址可信度已建立
RL地址和电话可信度已建立
RM地址和姓名可信度已建立
RN姓名可信度已建立
RO姓名和电话可信度已建立
RP电话可信度已建立
RQ设备和邮箱可信度已建立
RR设备和IP可信度已建立
RS地址和设备可信度已建立
TY设备和姓名可信度已建立
RU设备和电话可信度已建立
RV邮箱和支付信息可信度已建立
RWIP和支付信息可信度已建立
RX地址和支付信息可信度已建立
RY姓名和支付信息可信度已建立
RZ支付信息和电话可信度已建立