AuthorizeNet/AIM.pm

   1 package Business::OnlinePayment::AuthorizeNet::AIM;
   2
   3 use strict;
   4 use Carp;
   5 use Business::OnlinePayment::AuthorizeNet;
   6 use Net::SSLeay qw/make_form post_https make_headers/;
   7 use Text::CSV_XS;
   8 use vars qw($VERSION @ISA @EXPORT @EXPORT_OK);
   9
  10 require Exporter;
  11
  12 @ISA = qw(Exporter Business::OnlinePayment::AuthorizeNet);
  13 @EXPORT = qw();
  14 @EXPORT_OK = qw();
  15 $VERSION = '3.18';
  16
  17 sub set_defaults {
  18     my $self = shift;
  19
  20     $self->server('secure.authorize.net') unless $self->server;
  21     $self->port('443') unless $self->port;
  22     $self->path('/gateway/transact.dll') unless $self->path;
  23
  24     $self->build_subs(qw( order_number md5 avs_code cvv2_response
  25                           cavv_response
  26                      ));
  27 }
  28
  29 sub map_fields {
  30     my($self) = @_;
  31
  32     my %content = $self->content();
  33
  34     # ACTION MAP
  35     my %actions = ('normal authorization' => 'AUTH_CAPTURE',
  36                    'authorization only'   => 'AUTH_ONLY',
  37                    'credit'               => 'CREDIT',
  38                    'post authorization'   => 'PRIOR_AUTH_CAPTURE',
  39                    'void'                 => 'VOID',
  40                   );
  41     $content{'action'} = $actions{lc($content{'action'})} || $content{'action'};
  42
  43     # TYPE MAP
  44     my %types = ('visa'               => 'CC',
  45                  'mastercard'         => 'CC',
  46                  'american express'   => 'CC',
  47                  'discover'           => 'CC',
  48                  'check'              => 'ECHECK',
  49                 );
  50     $content{'type'} = $types{lc($content{'type'})} || $content{'type'};
  51     $self->transaction_type($content{'type'});
  52
  53     # ACCOUNT TYPE MAP
  54     my %account_types = ('personal checking'   => 'CHECKING',
  55                          'personal savings'    => 'SAVINGS',
  56                          'business checking'   => 'CHECKING',
  57                          'business savings'    => 'SAVINGS',
  58                         );
  59     $content{'account_type'} = $account_types{lc($content{'account_type'})}
  60                                || $content{'account_type'};
  61
  62     $content{'referer'} = defined( $content{'referer'} )
  63                             ? make_headers( 'Referer' => $content{'referer'} )
  64                             : "";
  65
  66     if (length $content{'password'} == 15) {
  67         $content{'transaction_key'} = delete $content{'password'};
  68     }
  69
  70     # stuff it back into %content
  71     $self->content(%content);
  72 }
  73
  74 sub remap_fields {
  75     my($self,%map) = @_;
  76
  77     my %content = $self->content();
  78     foreach(keys %map) {
  79         $content{$map{$_}} = $content{$_};
  80     }
  81     $self->content(%content);
  82 }
  83
  84 sub get_fields {
  85     my($self,@fields) = @_;
  86
  87     my %content = $self->content();
  88     my %new = ();
  89     foreach( grep defined $content{$_}, @fields) { $new{$_} = $content{$_}; }
  90     return %new;
  91 }
  92
  93 sub submit {
  94     my($self) = @_;
  95
  96     $self->map_fields();
  97     $self->remap_fields(
  98         type              => 'x_Method',
  99         login             => 'x_Login',
 100         password          => 'x_Password',
 101         transaction_key   => 'x_Tran_Key',
 102         action            => 'x_Type',
 103         description       => 'x_Description',
 104         amount            => 'x_Amount',
 105         currency          => 'x_Currency_Code',
 106         invoice_number    => 'x_Invoice_Num',
 107         order_number      => 'x_Trans_ID',
 108         auth_code         => 'x_Auth_Code',
 109         customer_id       => 'x_Cust_ID',
 110         customer_ip       => 'x_Customer_IP',
 111         last_name         => 'x_Last_Name',
 112         first_name        => 'x_First_Name',
 113         company           => 'x_Company',
 114         address           => 'x_Address',
 115         city              => 'x_City',
 116         state             => 'x_State',
 117         zip               => 'x_Zip',
 118         country           => 'x_Country',
 119         ship_last_name    => 'x_Ship_To_Last_Name',
 120         ship_first_name   => 'x_Ship_To_First_Name',
 121         ship_company      => 'x_Ship_To_Company',
 122         ship_address      => 'x_Ship_To_Address',
 123         ship_city         => 'x_Ship_To_City',
 124         ship_state        => 'x_Ship_To_State',
 125         ship_zip          => 'x_Ship_To_Zip',
 126         ship_country      => 'x_Ship_To_Country',
 127         phone             => 'x_Phone',
 128         fax               => 'x_Fax',
 129         email             => 'x_Email',
 130         email_customer    => 'x_Email_Customer',
 131         card_number       => 'x_Card_Num',
 132         expiration        => 'x_Exp_Date',
 133         cvv2              => 'x_Card_Code',
 134         check_type        => 'x_Echeck_Type',
 135         account_name      => 'x_Bank_Acct_Name',
 136         account_number    => 'x_Bank_Acct_Num',
 137         account_type      => 'x_Bank_Acct_Type',
 138         bank_name         => 'x_Bank_Name',
 139         routing_code      => 'x_Bank_ABA_Code',
 140         customer_org      => 'x_Customer_Organization_Type',
 141         customer_ssn      => 'x_Customer_Tax_ID',
 142         license_num       => 'x_Drivers_License_Num',
 143         license_state     => 'x_Drivers_License_State',
 144         license_dob       => 'x_Drivers_License_DOB',
 145         recurring_billing => 'x_Recurring_Billing',
 146         duplicate_window  => 'x_Duplicate_Window',
 147         track1            => 'x_Track1',
 148         track2            => 'x_Track2',
 149     );
 150
 151     my $auth_type = $self->{_content}->{transaction_key}
 152                       ? 'transaction_key'
 153                       : 'password';
 154
 155     my @required_fields = ( qw(type action login), $auth_type );
 156
 157     unless ( $self->{_content}->{action} eq 'VOID' ) {
 158
 159       if ($self->transaction_type() eq "ECHECK") {
 160
 161         push @required_fields, qw(
 162           amount routing_code account_number account_type bank_name
 163           account_name
 164         );
 165
 166         if (defined $self->{_content}->{customer_org} and
 167             length  $self->{_content}->{customer_org}
 168         ) {
 169           push @required_fields, qw( customer_org customer_ssn );
 170         } else {
 171           push @required_fields, qw(license_num license_state license_dob);
 172         }
 173
 174       } elsif ($self->transaction_type() eq 'CC' ) {
 175
 176         if ( $self->{_content}->{action} eq 'PRIOR_AUTH_CAPTURE' ) {
 177           if ( $self->{_content}->{order_number} ) {
 178             push @required_fields, qw( amount order_number );
 179           } else {
 180             push @required_fields, qw( amount card_number expiration );
 181           }
 182         } elsif ( $self->{_content}->{action} eq 'CREDIT' ) {
 183           push @required_fields, qw( amount order_number card_number );
 184         } else {
 185           push @required_fields, qw(
 186             amount last_name first_name card_number expiration
 187           );
 188         }
 189       } else {
 190         Carp::croak( "AuthorizeNet can't handle transaction type: ".
 191                      $self->transaction_type() );
 192       }
 193
 194     }
 195
 196     $self->required_fields(@required_fields);
 197
 198     my %post_data = $self->get_fields(qw/
 199         x_Login x_Password x_Tran_Key x_Invoice_Num
 200         x_Description x_Amount x_Cust_ID x_Method x_Type x_Card_Num x_Exp_Date
 201         x_Card_Code x_Auth_Code x_Echeck_Type x_Bank_Acct_Num
 202         x_Bank_Account_Name x_Bank_ABA_Code x_Bank_Name x_Bank_Acct_Type
 203         x_Customer_Organization_Type x_Customer_Tax_ID x_Customer_IP
 204         x_Drivers_License_Num x_Drivers_License_State x_Drivers_License_DOB
 205         x_Last_Name x_First_Name x_Company
 206         x_Address x_City x_State x_Zip
 207         x_Country
 208         x_Ship_To_Last_Name x_Ship_To_First_Name x_Ship_To_Company
 209         x_Ship_To_Address x_Ship_To_City x_Ship_To_State x_Ship_To_Zip
 210         x_Ship_To_Country
 211         x_Phone x_Fax x_Email x_Email_Customer x_Country
 212         x_Currency_Code x_Trans_ID x_Duplicate_Window x_Track1 x_Track2/);
 213
 214     $post_data{'x_Test_Request'} = $self->test_transaction() ? 'TRUE' : 'FALSE';
 215
 216     #deal with perl-style bool
 217     if (    $post_data{'x_Email_Customer'}
 218          && $post_data{'x_Email_Customer'} !~ /^FALSE$/i ) {
 219       $post_data{'x_Email_Customer'} = 'TRUE';
 220     } else {
 221       $post_data{'x_Email_Customer'} = 'FALSE';
 222     }
 223
 224     $post_data{'x_ADC_Delim_Data'} = 'TRUE';
 225     $post_data{'x_delim_char'} = ',';
 226     $post_data{'x_encap_char'} = '"';
 227     $post_data{'x_ADC_URL'} = 'FALSE';
 228     $post_data{'x_Version'} = '3.1';
 229
 230     my $pd = make_form(%post_data);
 231     my $s = $self->server();
 232     my $p = $self->port();
 233     my $t = $self->path();
 234     my $r = $self->{_content}->{referer};
 235     my($page,$server_response,%headers) = post_https($s,$p,$t,$r,$pd);
 236     #escape NULL (binary 0x00) values
 237     $page =~ s/\x00/\^0/g;
 238
 239     #trim 'ip_addr="1.2.3.4"' added by eProcessingNetwork Authorize.Net compat
 240     $page =~ s/,ip_addr="[\d\.]+"$//;
 241
 242     my $csv = new Text::CSV_XS({ binary=>1, escape_char=>'' });
 243     $csv->parse($page);
 244     my @col = $csv->fields();
 245
 246     $self->server_response($page);
 247     $self->avs_code($col[5]);
 248     $self->order_number($col[6]);
 249     $self->md5($col[37]);
 250     $self->cvv2_response($col[38]);
 251     $self->cavv_response($col[39]);
 252
 253     if($col[0] eq "1" ) { # Authorized/Pending/Test
 254         $self->is_success(1);
 255         $self->result_code($col[0]);
 256         if ($col[4] =~ /^(.*)\s+(\d+)$/) { #eProcessingNetwork extra bits..
 257           $self->authorization($2);
 258         } else {
 259           $self->authorization($col[4]);
 260         }
 261     } else {
 262         $self->is_success(0);
 263         $self->result_code($col[2]);
 264         $self->error_message($col[3]);
 265         unless ( $self->result_code() ) { #additional logging information
 266           #$page =~ s/\x00/\^0/g;
 267           $self->error_message($col[3].
 268             " DEBUG: No x_response_code from server, ".
 269             "(HTTPS response: $server_response) ".
 270             "(HTTPS headers: ".
 271               join(", ", map { "$_ => ". $headers{$_} } keys %headers ). ") ".
 272             "(Raw HTTPS content: $page)"
 273           );
 274         }
 275     }
 276 }
 277
 278 1;
 279 __END__
 280
 281 =head1 NAME
 282
 283 Business::OnlinePayment::AuthorizeNet::AIM - AuthorizeNet AIM backend for Business::OnlinePayment
 284
 285 =head1 AUTHOR
 286
 287 Jason Kohles, jason@mediabang.com
 288
 289 Ivan Kohler <ivan-authorizenet@420.am> updated it for Authorize.Net protocol
 290 3.0/3.1 and is the current maintainer.  Please send patches as unified diffs
 291 (diff -u).
 292
 293 Jason Spence <jspence@lightconsulting.com> contributed support for separate
 294 Authorization Only and Post Authorization steps and wrote some docs.
 295 OST <services@ostel.com> paid for it.
 296
 297 T.J. Mather <tjmather@maxmind.com> sent a number of CVV2 patches.
 298
 299 Mike Barry <mbarry@cos.com> sent in a patch for the referer field.
 300
 301 Yuri V. Mkrtumyan <yuramk@novosoft.ru> sent in a patch to add the void action.
 302
 303 Paul Zimmer <AuthorizeNetpm@pzimmer.box.bepress.com> sent in a patch for
 304 card-less post authorizations.
 305
 306 Daemmon Hughes <daemmon@daemmonhughes.com> sent in a patch for "transaction
 307 key" authentication as well support for the recurring_billing flag and the md5
 308 method that returns the MD5 hash which is returned by the gateway.
 309
 310 Steve Simitzis contributed a patch for better compatibility with
 311 eProcessingNetwork's AuthorizeNet compatability mode.
 312
 313 =head1 SEE ALSO
 314
 315 perl(1). L<Business::OnlinePayment> L<Business::OnlinePayment::AuthorizeNet>.
 316
 317 =cut
 318