X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;f=FraudDetect.pm;h=c19323988575e537cc8ec340a4af5ff45287bf0a;hb=d1812ae60145e3344f999f284bfc9c5ec05cbcf0;hp=834e135c53aa7d4989e07e182071e69b6f7d4415;hpb=5cbc63f2a9e6fa44b19a5b98edcdf6ef47d8b1eb;p=Business-OnlinePayment.git

diff --git a/FraudDetect.pm b/FraudDetect.pm
index 834e135..c193239 100644
--- a/FraudDetect.pm
+++ b/FraudDetect.pm
@@ -8,3 +8,80 @@ $VERSION = '0.01';
 @ISA = qw / Business::OnlinePayment /;
 
 1;
+
+=pod
+
+=head1 NAME
+
+Business::FraudDetect - A cohort to Business::OnlinePayment
+
+=head1 SYNOPSIS
+
+  my %processor_info = ( fraud_detection => 'preCharge',
+                         maximum_fraud_score => 500,
+                         preCharge_id => '1000000000000001',
+                         preCharge_security1 => 'abcdef0123',
+                         preCharge_security2 => '3210fedcba',
+                        )
+  my $transaction = new Business::OnlinePayment($processor, %processor_info);
+  $transaction->content(
+                        type       => 'Visa',
+                        amount     => '49.95',
+                        cardnumber => '1234123412341238',
+                        expiration => '0100',
+                        name       => 'John Q Doe',
+                       );
+  $transaction->submit();
+
+  if($transaction->is_success()) {
+    print "Card processed successfully: ".$transaction->authorization()."\n";
+  } else {
+    print "Card was rejected: ".$transaction->error_message()."\n";
+  }
+
+=head1 DESCRIPTION
+
+This is a module that adds functionality to Business::OnlinePayment.  See L<Business::OnlinePayment>.
+
+The user instantiates a Business::OnlinePayment object per usual, adding in three processor directives
+
+=over 4
+
+=item *  fraud_detection
+
+Which Fraud Detection module to use.
+
+=item *  maximum_fraud_score
+
+FraudDetection drivers are expected to return a numeric "risk" factor, this parameter allows you to set the threshold to reject the transaction based on that risk.  Higher numbers are "riskier" transactions.
+
+=item * other driver-specific parameters.
+
+Consult the specific Fraud Detection module you intend to use for its required parameters.
+
+=back
+
+The $tx->submit() method is overridden to interpose a FraudDetection phase.  A subordinate object is created using the same content as the parent OnlinePayment object, and a I<Fraud Detect> action is run against that subordinate object.  If the resulting fraud score is less than or equal to the maximum_risk parameter, the parent transaction will be allowed to proceed.  Otherwise, a failure state will exist with a suitable error message.
+
+=head1 METHODS
+
+This module provides no new methods.  It does, however override the
+submit method to interpose an additional Fraud Detection phase. 
+
+=head1 AUTHORS
+
+Original author: Lawrence Statton <lawrence@cluon.com>
+
+Current maintainer: Ivan Kohler <ivan-bop@420.am> as part of the
+Business::OnlinePayment distribution.
+
+=head1 DISCLAIMER
+
+THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+
+=head1 SEE ALSO
+
+L<Business::OnlinePayment>, http://420.am/business-onlinepayment
+
+
+=cut