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)

Business::OnlinePayment::TransactionCentral(3pm)	User Contributed Perl Documentation	  Business::OnlinePayment::TransactionCentral(3pm)

NAME

       Business::OnlinePayment::TransactionCentral - Transaction Central backend module for Business::OnlinePayment

SYNOPSIS

	 use Business::OnlinePayment;

	 ####
	 # One step transaction, the simple case.
	 ####

	 my $tx = new Business::OnlinePayment("TransactionCentral");
	 $tx->content(
	     type	    => 'CC',
	     login	    => '10011', #MerchantID
	     password	    => 'KK48NPYEJHMAH6DK', #Regkey
	     action	    => 'Normal Authorization',
	     description    => 'Business::OnlinePayment test',
	     amount	    => '49.95',
	     name	    => 'Tofu Beast',
	     address	    => '123 Anystreet',
	     city	    => 'Anywhere',
	     state	    => 'UT',
	     zip	    => '84058',
	     phone	    => '420-867-5309',
	     email	    => 'tofu.beast@example.com',
	     card_number    => '4012000000001',
	     expiration     => '08/06',
	     cvv2	    => '1234', #optional
	 );
	 $tx->submit();

	 if($tx->is_success()) {
	     print "Card processed successfully: ".$tx->authorization."
";
	 } else {
	     print "Card was rejected: ".$tx->error_message."
";
	 }
       =head1 DESCRIPTION

       This is a Business::OnlinePayment backend module for the Transaction Central (MerchantAnywhere, PRIMerchants) gateway.  It is only useful
       if you have a merchant account with MerchantAnywhere / PRIMerchants:

       http://www.merchantanywhere.com/ http://www.merchantanywhere.com/ecshop/TC_elink.htm

       http://www.primerchants.com/ http://www.primerchants.com/info/transactioncentral.asp

SUPPORTED TRANSACTION TYPES

       CC, Visa, MasterCard, American Express, Discover

       Content required: type, login, password, action, amount, card_number, expiration, name, address, zip.

       ECHECK

       Content required: type, login, password, action, amount, account_number, routing_code, name

PREREQUISITES

	 URI::Escape

	 Net::SSLeay _or_ ( Crypt::SSLeay and LWP )

DESCRIPTION

       For detailed information see Business::OnlinePayment.

NOTE

       The newest publicly available documentation is available at:

       http://www.merchantanywhere.com/ecshop/TC%20Interface%20NEW.pdf

       It is somewhat out-of-date and contains a few discrepancies.  Google "TCInterfaceGuide" for current documentation.

AUTHOR

       Ivan Kohler <ivan-transactioncentral@420.am>

COPYRIGHT AND LICENSE

       Copyright (C) 2006 by Ivan Kohler Copyright (C) 2007 Freeside Internet Services, Inc.

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

SEE ALSO

       perl(1). Business::OnlinePayment.

perl v5.8.8							    2008-02-27			  Business::OnlinePayment::TransactionCentral(3pm)