/ 
Business-MaxMind-1.60
River stage zero No dependents
/ Business::MaxMind::CreditCardFraudDetection

NAME

Business::MaxMind::CreditCardFraudDetection - Access MaxMind minFraud services

VERSION

version 1.60

SYNOPSIS

use Business::MaxMind::CreditCardFraudDetection;

my $minfraud =
  Business::MaxMind::CreditCardFraudDetection->new(
                                                    isSecure => 1,
                                                    debug    => 0,
                                                    timeout  => 10,
);
$minfraud->input(
       i               => '24.24.24.24',
       city            => 'New York',
       region          => 'NY',
       postal          => '10011',
       country         => 'US',
       domain          => 'yahoo.com',            # optional
       bin             => '549099',               # optional
       binName         => 'MBNA America Bank',    # optional
       binPhone        => '800 421 2110',         # optional
       custPhone       => '212-242',              # optional Area Code + Local Exchange
       user_agent      => 'Mozilla/4.0',          # optional
       accept_language => 'en',                   # optional
       license_key     => 'LICENSE_KEY_HERE'
);
$minfraud->query;

my $hash_ref = $minfraud->output;

DESCRIPTION

This module queries the MaxMind minFraud service and returns the results. The service uses a free e-mail database, an IP address geography database, a bank identification number, and proxy checks to return a risk factor score representing the likelihood that the credit card transaction is fraudulent.

METHODS

new

Class method that returns a Business::MaxMind::CreditCardFraudDetection object. If isSecure is set to 1, it will use a secure connection. If debug is set to 1, will print debugging output to standard error. timeout parameter is used to set timeout in seconds, if absent default value for timeout is 10 seconds.

input

Sets input fields. The input fields are

  • i: Client IP Address (IP address of customer placing order)
  • domain: E-mail domain (e.g. hotmail.com, aol.com)
  • city, region, postal, country: Billing City/State/ZipCode/Country
  • bin: BIN number, first 6 digits of credit card that identifies the issuing bank, optional
  • binName: Name of the bank which issued the credit card based on BIN number, optional
  • binPhone: Customer service phone number listed on back of credit card, optional
  • custPhone: Area code and local exchange of customer's phone number, optional
  • license_key: License Key, for registered users, optional
  • user_agent: User-Agent HTTP header, identifies the browser the end-user is using. optional
  • accept_language: Accept-Language HTTP header, identifies the language settings of the browser the end-user is using. optional

See http://dev.maxmind.com/minfraud/ for full list of input fields.

Returns 1 on success, 0 on failure.

query

Sends out query to MaxMind server and waits for response. If the primary server fails to respond, it sends out a request to the secondary server.

output

Returns the output returned by the MaxMind server as a hash reference.

SEE ALSO

https://www.maxmind.com/en/minfraud-services

AUTHORS

  • TJ Mather <tjmather@maxmind.com>

  • Frank Mather <frank@maxmind.com>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2015 by MaxMind, Inc..

This is free software, licensed under:

The GNU General Public License, Version 2, June 1991