minFraud 网络服务API

HTTP API

此 HTTP API 需要您通过HTTP POST 设置 JSON.

这个服务的URL为  https://minfraud.maxmind.com/minfraud/chargeback.

 minfraud.maxmind.com 域名会自动选择离您最近的一个MaxMind数据中心。 某些特殊情况下,这个数据中心不是您的最佳选择。您可以尝试人工选择 minfraud-us-east.maxmind.com 或者minfraud-us-west.maxmind.com 以便使我们能够更好的服务您。

验证

HTTP 验证 需要使用 验证的 Header. 用户名为您的 MaxMind user ID. 密码为您的 MaxMind license key. 您必须购买我们的产品或者申请试用以便获得User ID以及License Key。

我们使用基础 HTTP 加密, 但是需要加密的API都通过HTTPS, 这样所有的信息都是加密传输的。 如果您试图使用HTTP接入这个服务, 您会得到 404 Not Found.

格式

 minFraud API 接受 HTTP POST 附加的JSON . JSON document 应该含有一个物件。 物件可以包含以下数据:

名字 类型 说明

必须填写

以下的条目必须填写

ip_address string

客户下订单的IP地址。 例如 “44.55.66.77” 或者 “2001:db8::2:1”.

可选择填写

以下条目可以根据您是否拥有填写.

chargeback_code string

交易处理器返回的取消代码.

fraud_score string

交易有多大可能为欺诈。 可能数值: ‘not_fraud’, ‘suspected_fraud’, ‘known_fraud’.

maxmind_id integer

MaxMind的单笔交易查询ID。我们强烈推荐您提供此条目。

transaction_id string

您提交给MaxMind的交易ID。强烈建议您提供此条目或者maxmind_id条目.

查询起始

 Content-Type Header起始为 application/json.

反馈

HTTP 状态码会告知您是否成功完成查询. 一个成功的查询会反馈204.

当反馈状态码为错误时(4xx 或者 5xx), 反馈可能会包括一个JSON物件. 物件把偶偶条目 code 以及 error.

客户的代码应该能支持所有的HTTP错误。

代码 HTTP状态 说明

Error Codes

FRAUD_SCORE_INVALID 400 Bad Request

反馈至可能为 ‘not_fraud’, ‘suspected_fraud’ 以及 ‘known_fraud’.

JSON_INVALID 400 Bad Request

您的JSON代码有误。可以使用 jsonlint.com 帮助您检查。

MAXMIND_ID_INVALID 400 Bad Request

您的maxmind_id有误。

PARAMETER_UNKNOWN 400 Bad Request

您的条目不能被识别

IP_ADDRESS_INVALID 400 Bad Request

您的IP地址有误

IP_ADDRESS_REQUIRED 400 Bad Request

您未提供IP地址

IP_ADDRESS_RESERVED 400 Bad Request

您提供的IP不是可使用的。

AUTHORIZATION_INVALID 401 Unauthorized

您的UserID/Licensekey有误

LICENSE_KEY_REQUIRED 401 Unauthorized

您没有提供license_key.

USER_ID_REQUIRED 401 Unauthorized

您没有提供userID

(none) 415 Unsupported Media Type

您的起始我们不支持

(none) 503 Service Not Available

服务器问题,请稍后再试.

客户代码案列

Perl

curl