minFraud 网络服务API

minFraud网络服务API用SOAP驱动,也可以用简单URL。您需要一个MaxMind的 licensekey使用。

更新日志

minFraud更新说明在 更新日志.

API

我们鼓励客户使用我们的API。

语言/平台 说明 打包方式 版本控制
ASP 说明 Source GitHub
Java 说明 Maven Central Repository GitHub
Perl 说明 MetaCPAN GitHub
PHP 说明 Composer / Source GitHub

API会帮您调整输入格式.

欺诈返款报告

如果您使用我们的服务,并且被欺诈强制返款了,请报告给我们以便我们更好的调整我们的服务。

设备追踪

你可以在网页中添加一些 JavaScript 以便帮我们确定改设备是否曾经被用于欺诈,这项指标会反馈在riskScore中。

HTTP API

如果您想使用的API不在以上列表中,我们有一个如下API。

您需要把参数设定为HTTP GET 或者 POST. 反馈值用文本形式返回。

该服务的URL为 https://minfraud.maxmind.com/app/ccv2r.

 minfraud.maxmind.com 域名自动识别离你最近的服务器。有些情况下,这个服务器不是能为您提供最佳服务的服务器。您可以手动选择这两个域名: minfraud-us-east.maxmind.com 以及minfraud-us-west.maxmind.com 中的一个。

输入

minFraud API 支持字符串输入 (application/x-www-form-urlencoded). 所有输入大小写有区别。

大部分的输入对于长度没有要求,但是有几个特别说明的需要注意输入长度。

名字 类型(长度) 说明

必须输入

以下数据必须输入

i string 下单IP,格式为: “44.55.66.77” 或者 “2001:db8::2:1”.
city string 客户账单城市
region string 客户账单州/省
postal string 客户账单邮编
country string 客户账单国家,可以用名字或者 ISO 3166 标准。
license_key string 您的MaxMind license key.

寄送地址

我们会查询高危送货地址。

shipAddr string 送货街道
shipCity string 送货城市
shipRegion string 送货省/州
shipPostal string 送货邮编
shipCountry string 送货国家

用户信息

有些输入要求用MD5 哈希。哈希应该在所有字母都是小写的时候进行。不要添加salt。

domain string 客户的邮件域名
custPhone string 客户电话,我们忽略所有非数字输入。
emailMD5 string (32) 客户email的MD5
usernameMD5 string (32) 客户用户名好的MD5

BIN-相关

主要认证客户是否本人持卡

bin string 信用卡BIN – 即信用卡前六位。用于识别发行银行。
binName string 发行银行名字-必须输入bin
binPhone string 发信银行电话-必须输入bin

交易关联

 

sessionID string 启动ID
user_agent string User-Agent HTTP 起始
accept_language string Accept-Language HTTP 起始

交易信息

交易的一些相关信息

txnID string 单内ID
order_amount decimal (20, 3) 下单金额
order_currency string (3) ISO 4217 格式的币种
shopID string 您的内部ID
txn_type enum

交易类型,如下几种

  • creditcard
  • debitcard
  • paypal
  • google – Google checkout
  • other
  • lead – lead generation
  • survey – online survey
  • sitereg – site registration

The lead, survey, and sitereg types are used for non-purchase transactions.

信用卡检测

您必须进行AVS或者CVV检测后才能给我们发送如下信息

avs_result enum AVS检测结果
cvv_result enum

CVV检测结果(y或者n)切记:不要给我们CVV!

其他

requested_type enum

可以设为 “standard”或者”premium”. 您使用的查询的级别。我们默认使用您账户上的最高级别

forwardedIP string 客户用透明代理时的终端IP。

输出

minFraud输出用分号 (;)隔开. 每一个输出的名字和数值用等号(=)关联. 数值不含以上两种符号

所有字符串为ISO-8859-1 标准. 这种方式也被称作为 latin1.

以下是一个输出样例:

riskScore=13.2;distance=6;countryMatch=Yes;countryCode=US;freeMail=Yes

API版本条目告诉你哪个版本API加入该输出项目的. 你可以选择旧版本输入. 默认客户输出为他们购买服务时的版本,最新版本为1.3.

名字 类型 (长度) 说明 加入版本

Risk Score

riskScore decimal 欺诈可能性 0.1 – 99.9 1.1
score decimal 老版本的可能性。我们不再支持 1.0
explanation string 我们不再支持 1.0

地理位置

countryMatch enum 账单和IP国家匹配 yes或者 no 1.0
highRiskCountry enum 是否为高危国家 1.0
distance integer IP到账单地址距离,越高越有可能是欺诈 1.0
ip_accuracyRadius integer IP地址准确范围 1.2
ip_city string IP地址的城市 1.0
ip_region string (2)

 IP地址的州/省ISO-3166-2 FIPS 10-4 标准

我们还会反回如下代码:

  • AA – Armed Forces America
  • AE – Armed Forces Europe
  • AP – Armed Forces Pacific

我们提供一个 CSV 识别我们返回的代码. 列分别为 ISO 国家码, 地区码 (FIPS 或 ISO), 和地区名字、

1.0
ip_regionName string IP地区名字 1.2
ip_postalCode string IP邮编,不一定有 1.2
ip_metroCode integer IP metrocode 1.2
ip_areaCode string IP美国区号 1.2
countryCode string (2)

ISO 3166-1 标准的国家码。还有如下码:

  • A1 – 匿名代理
  • A2卫星服务商.
  • EU – 多个欧洲国家共有.
  • AP – 多个亚洲国家共有.

 

1.0
ip_countryName string IP国家名字 1.2
ip_continentCode string (2)

IP所在大洲

  • AF – 非洲
  • AS – 亚洲
  • EU – 欧洲
  • NA – 北美洲
  • OC – 大洋洲
  • SA – 南美洲
1.2
ip_latitude decimal IP纬度 1.0
ip_longitude decimal IP经度 1.0
ip_timeZone string IP时区 1.2
ip_asnum string IP奇奇怪怪的东西 1.2
ip_userType enum

用户类型

  • business
  • cafe
  • cellular
  • college
  • contentDeliveryNetwork
  • government
  • hosting
  • library
  • military
  • residential
  • router
  • school
  • searchEngineSpider
  • traveler
1.2
ip_netSpeedCell enum

网络连接类型

  • Dialup
  • Cable/DSL
  • Corporate
  • Cellular
1.2
ip_domain string IP所在的二级域名 1.2
ip_isp string IP所在ISP 1.0
ip_org string IP所在单位 1.0
ip_cityConf decimal 我们认为IP城市对的可能性,0-100 1.2
ip_regionConf decimal 同上,地域 1.2
ip_postalConf decimal 同上,邮编 1.2
ip_countryConf decimal 同上,国家 1.2

代理检测

以下包含这个IP是否为代理,以及是什么样的代理

anonymousProxy enum 是否为匿名代理。匿名代理危险性高。 1.0
proxyScore decimal
一个0-4分的指标
proxyScore 非法可能性
0.5 15%
1.0 30%
2.0 60%
3.0+ 90%

 

非法IP回返回空,私人IP返回0.0.

1.0
isTransProxy enum 是否为透明代理 1.0
ip_corporateProxy enum 是否为知名公司代理(VPN之类) 1.2

邮箱,账户名检测

一些相关信息

freeMail enum 是否为免费邮件提供商 1.0
carderEmail enum 是否为已知高危邮箱 1.0
highRiskUsername 什么也没有 1.0
highRiskPassword 什么也没有 1.0

银行检测

用户所在银行以及相关信息

binMatch enum

可以为Yes, No, NotFound 或 NA 。银行的BIN码和用户IP是否吻合。没有找到银行BIN为 NotFound。没有输入为NA。

1.1
binCountry string (2)  ISO 3166 标准的BIN国家. 高级服务才会返回 1.1
binNameMatch enum 用户提供的银行是否和卡上BIN吻合。同binMatch。 1.1
binName string BIN银行名字。高级服务专属。
1.1
binPhoneMatch enum 同binMatch。电话号码。 1.1
binPhone string BIN电话号码,75%几率返回,高级服务专属 1.1
prepaid enum 是否为预付卡。 1.3

地址和电话

有关用户地址和电话的信息

custPhoneInBillingLoc enum

可以为Yes, No, or NotFound.电话号码区号是否属于该邮编

1.0
shipForward enum

是否为高位地址,NotFound是我们不能识别该地址。

1.0
cityPostalMatch enum 账单城市和邮编是否吻合 1.0
shipCityPostalMatch enum 寄送城市是否和邮编吻合。 1.0

账户信息

MaxMind账户信息

queriesRemaining integer 剩余查询额 1.0
maxmindID string (8) MaxMind内部ID 1.0
minfraud_version string API版本 1.0
service_level enum 该次查询用的什么级别的服务 1.0

错误返回

err enum

如果查询有错误,会返回如下:

可能返回:

  • INVALID_LICENSE_KEY
  • IP_REQUIRED
  • IP_NOT_FOUND – 找不到IP.
  • LICENSE_REQUIRED
  • COUNTRY_REQUIRED
  • MAX_REQUESTS_REACHED – 免费用户用完查询,该充值了。

可能警告:

  • COUNTRY_NOT_FOUND
  • CITY_NOT_FOUND
  • CITY_REQUIRED
  • POSTAL_CODE_REQUIRED
  • POSTAL_CODE_NOT_FOUND
1.0

SOAP API

MaxMind给minFraud服务提供SOAP API。 我们推荐您使用最近版本。