README

关于

作者: Dmitry Vrublevskis

安装

Composer

推荐通过 composer 安装。在 composer.json 中添加

"require": {
    "fylmtm/maxmind-api": "0.1.*@dev"
}

然后使用以下命令安装

$ composer.phar install

手动安装

您可以手动下载库并使用自动加载器。

require_once 'lib/autoloader.php'

使用方法

MinFraud 客户端

创建客户端

$fraudClient = new Maxmind\MinFraud\MinFraudClient();

默认使用主服务器。您可以选择任何您想要的

$fraudClient->setServer(\Maxmind\MinFraud\MinFraudServers::MAIN);
$fraudClient->setServer(\Maxmind\MinFraud\MinFraudServers::US_EAST);
$fraudClient->setServer(\Maxmind\MinFraud\MinFraudServers::US_WEST);

默认使用 HTTPS。您可以开启/关闭 HTTPS 使用

$fraudClient->enableHttps(false);

MinFraud 请求

minFraud API 参考

您需要创建请求，稍后将其传递给 fraudClient。必须在创建客户端时传递必要请求字段。默认使用 standard 请求类型。

// Exception may be thrown, if any of required fields will not be passed.
$request = new Maxmind\MinFraud\MinFraudRequest([
    'license_key' => '1111111',
    'i'           => '257.257.257.257',
    'city'        => 'BigApple',
    'region'      => 'NA',
    'postal'      => '1111',
    'country'     => 'NA',
]);
$request->setRequestType('standard'); // 'standard' or 'premium' request type can be used.

其他字段（更多信息请参阅 API 参考）可以单独传递。

$request->setShippingAddress([
    'shipAddr' => '',
    'shipCity' => '',
    'shipRegion' => '',
    'shipPostal' => '',
    'shipCountry' => ''
]);
$request->setUserData([
    'domain' => '',
    'custPhone' => '',
    'emailMD5' => '',
    'usernameMD5' => '',
    'passwordMD5' => ''
]);
$request->setBinRelated([
    'bin' => '',
    'binName' => '',
    'binPhone' => ''
]);
$request->setTransactionLinking([
    'sessionID' => '',
    'user_agent' => '',
    'accept_language' => ''
]);
$request->setTransactionInformation([
    'txnID' => '',
    'order_amount' => '',
    'order_currency' => '',
    'shopID' => '',
    'txn_type' => ''
]);
$request->setCreditCardCheck([
    'avs_result' => '',
    'cvv_result' => ''
]);
$request->setMisc([
    'forwardedIP' => ''
]);

MinFraud 响应

可以通过客户端执行请求。

$response = $fraudClient->executeRequest($request);
$response->getIsCurlSuccessful(); // true|false - indicates if curl was successfull
$response->getRawResult(); // string - raw curl response, contains error if curl was unsuccessful
$response->getResult(); // parsed minFraud response

测试

如果您想运行测试，您需要安装开发依赖项

$ composer.phar install --dev

然后使用以下命令运行它们

$ vendor/bin/phpunit

fylmtm / maxmind-api

维护者

详细信息