NAME

WebService::MinFraud::Model::Insights - Model class for minFraud Insights

VERSION

version 0.001001

SYNOPSIS

  use 5.010;

  use WebService::MinFraud::Client;

  my $client = WebService::MinFraud::Client->new(
      user_id     => 42,
      license_key => 'abcdef123456',
  );

  my $request = { device => { ip_address => '24.24.24.24' } };
  my $insights = $client->insights($request);

  my $shipping_address = $insights->shipping_address;
  say $shipping_address->is_high_risk;

  my $ip_address = $insights->ip_address;
  my $postal     = $ip_address->postal;
  say $postal->code;

DESCRIPTION

This class provides a model for the data returned by the minFraud Insights web service.

The Insights model class includes more data than the Score model class. See the API documentation for more details.

METHODS

This model class provides the following methods:

billing_address

Returns a WebService::MinFraud::Record::BillingAddress object representing billing data for the transaction.

credit_card

Returns a WebService::MinFraud::Record::CreditCard object representing credit card data for the transaction.

credits_remaining

Returns the approximate number of service credits remaining on your account. The service credit counts are near realtime so they may not be exact.

id

Returns a UUID that identifies the minFraud request. Please use this UUID in bug reports or support requests to MaxMind so that we can easily identify a particular request.

ip_address

Returns a WebService::MinFraud::Record::IPAddress object representing IP address data for the transaction. This object has the following methods:

• city

• continent

• country

• most_specific_subdivision

• postal

• registered_country

• represented_country

• risk

• subdivisions

• traits

For details, please refer to "METHODS" in WebService::MinFraud::Record::IPAddress.

risk_score

Returns the risk score which is a number between 0.01 and 99. A higher score indicates a higher risk of fraud.

shipping_address

Returns a WebService::MinFraud::Record::ShippingAddress object representing shipping data for the transaction.

warnings

Returns an ArrayRef of WebService::MinFraud::Record::Warning objects. It is highly recommended that you check this array for issues when integrating the web service.

PREDICATE METHODS

The following predicate methods are available, which return true if the related data was present in the response body, false if otherwise:

has_credits_remaining

has_id

has_risk_score

has_warnings

AUTHOR

Mateu Hunter <mhunter@maxmind.com>

COPYRIGHT AND LICENSE

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

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

cpanm WebService::MinFraud

perl -MCPAN -e shell
install WebService::MinFraud