business::onlinepayment::https(3pm) [debian man page]

OnlinePayment::HTTPS(3pm)				User Contributed Perl Documentation				 OnlinePayment::HTTPS(3pm)

NAME

       Business::OnlinePayment::HTTPS - Base class for HTTPS payment APIs

SYNOPSIS

	 package Business::OnlinePayment::MyProcessor;
	 use base qw(Business::OnlinePayment::HTTPS);

	 sub submit {
	     my $self = shift;

	     #...

	     # pass a list (order is preserved, if your gateway needs that)
	     ( $page, $response, %reply_headers )
		 = $self->https_get( field => 'value', ... );

	     # or a hashref
	     my %hash = ( field => 'value', ... );
	     ( $page, $response_code, %reply_headers )
		   = $self->https_get( \%hash );

	     #...
	 }

DESCRIPTION

       This is a base class for HTTPS based gateways, providing useful code for implementors of HTTPS payment APIs.

       It depends on Net::HTTPS::Any, which in turn depends on Net::SSLeay _or_ ( Crypt::SSLeay and LWP::UserAgent ).

METHODS

       https_get [ \%options ] HASHREF | FIELD => VALUE, ...
	   Accepts parameters as either a hashref or a list of fields and values.  In the latter case, ordering is preserved (see Tie::IxHash to
	   do so when passing a hashref).

	   Returns a list consisting of the page content as a string, the HTTP response code and message (i.e. "200 OK" or "404 Not Found"), and a
	   list of key/value pairs representing the HTTP response headers.

	   The options hashref supports setting headers:

	     {
		 headers => { 'X-Header1' => 'value', ... },
	     }

       https_post [ \%options ] SCALAR | HASHREF | FIELD => VALUE, ...
	   Accepts form fields and values as either a hashref or a list.  In the latter case, ordering is preserved (see Tie::IxHash to do so when
	   passing a hashref).

	   Also accepts instead a simple scalar containing the raw content.

	   Returns a list consisting of the page content as a string, the HTTP response code and message (i.e. "200 OK" or "404 Not Found"), and a
	   list of key/value pairs representing the HTTP response headers.

	   The options hashref supports setting headers and Content-Type:

	     {
		 headers => { 'X-Header1' => 'value', ... },
		 Content-Type => 'text/namevalue',
	     }

SEE ALSO

       Business::OnlinePayment, Net::HTTPS::Any

perl v5.12.4							    2010-05-25						 OnlinePayment::HTTPS(3pm)

FraudDetect(3pm)					User Contributed Perl Documentation					  FraudDetect(3pm)

NAME

       Business::FraudDetect - A cohort to Business::OnlinePayment

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()."
";
	 } else {
	   print "Card was rejected: ".$transaction->error_message()."
";
	 }

DESCRIPTION

       This is a module that adds functionality to Business::OnlinePayment.  See Business::OnlinePayment.

       The user instantiates a Business::OnlinePayment object per usual, adding in three processor directives

       o   fraud_detection

	   Which Fraud Detection module to use.

       o   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.

       o   other driver-specific parameters.

	   Consult the specific Fraud Detection module you intend to use for its required parameters.

       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 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.

METHODS

       This module provides no new methods.  It does, however override the submit method to interpose an additional Fraud Detection phase.

AUTHORS

       Original author: Lawrence Statton <lawrence@cluon.com>

       Current maintainer: Ivan Kohler <ivan-bop@420.am> as part of the Business::OnlinePayment distribution.

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.

SEE ALSO

       Business::OnlinePayment, http://420.am/business-onlinepayment

perl v5.12.4							    2007-06-13							  FraudDetect(3pm)