eProcessingNetwork offers the following sample Perl source code to assist developers in integrating the eProcessingNetwork Transparent Database Engine Template for payment processing.

Use of this integration template and source code requires intermediate- to advanced-level programming capability. eProcessingNetwork offers support for this template and source code via email only at DevUtils@eProcessingNetwork.Com.

Please note the following:

  • The sample source code shown below uses hard-coded values. You, as a programmer, must replace these hard-coded values with the values you prompt customers for.

  • The hard-coded test account number can be used if you do not yet have an eProcessingNetwork account. A test transaction can be run at anytime by simply using the merchants eProcessingNetwork account number as the credit card number, regardless of whether you are using a test account number or a live account number.

  • ExpMonth and ExpYear must both be in two-digit format or you will very definitely achieve unexpected results because of the different ways issuing banks process transactions.

The required format of the variable names to pass to the eProcessingNetwork Transparent Database Engine Template is as follows:

ePNAccount, CardNo, ExpMonth, ExpYear, Total,
Address, Zip, CVV2Type, CVV2

CVV2Type, related values and sample HTML are documented here.

This Perl source requires Perl modules/libraries that are widely available. It is assumed here that the programmer understands the importance of these modules/libraries, and knows how to install them.

use LWP::UserAgent;
use Crypt::SSLeay;

my $ua = new LWP::UserAgent;

my $remote_url =
   'https://www.eProcessingNetwork.Com/cgi-bin/tdbe/transact.pl';

my $request = new HTTP::Request( 'POST', $remote_url );

$request->content_type( 'application/x-www-form-urlencoded' );

$stg = "ePNAccount=05971&CardNo=05971&ExpMonth=10&ExpYear=01
      &Total=12.95&Address=123 Main St.&Zip=123456789
      &CVV2Type=1&CVV2=123&HTML=No";
$request->content( $stg );

my $response = $ua->request($request);
@response = split( /,/, $response->content ); # split into array
@response[0] =~ s/["]//g; # remove quotes
@response[1] =~ s/["]//g; # remove quotes
@response[2] =~ s/["]//g; # remove quotes

$approval = substr( @response[0], 0, 1 );

print "Content-type: text/html\n\n";
print "<html><body>";

if( $approval eq 'Y' )
{
   print "Your transaction has been approved
      with the following response: <b>"
      . substr( @response[0], 1, 16 ) . "</b><br>";
   print "AVS Response: <b>" . @response[1] . "</b><br>";
   print "CVV2 Response: <b>" . @response[2] . "</b><br>";
}
elsif( $approval eq 'N' )
{
   print "Your transaction has been declined with the following
    response: <b>" . substr( @response[0], 1 )
    . "</b><br>";
}
else
{
   print "The processor was unable to handle your transaction,
    having returned the following response: <b>"
    . substr( @response[0], 1 ) . "</b><br>";
}

print "</body></html>";

By default, the eProcessingNetwork Transparent Database Engine Template outputs its' response in HTML format, i.e. wrapped in <html> and <body> tags, which can often aid in testing. Sending the additional variable HTML set to No causes the template to output the response without the HTML tags.

After the transaction has been processed, the banks' response to the transaction, as well as the Address Verification System and CVV2 responses, are output as follows:

With HTML:

<html><body>"YAUTH/TKT 019829","Address and Zip Code Do Not Match","CVV2 Not a Match"</body></html>

Without HTML:

"YAUTH/TKT 019829","Address and Zip Code Do Not Match","CVV2 Not a Match"

The response is essentially three quoted, comma-delimited strings. The first string always starts with a Y (Yes, approved), an N (No, declined) or a U (No, unable), and is followed by up to 16 characters describing the response. The second string is the Address Verification Systems' response to the street address and Zip code supplied. The third string is the processors response to the CVV2 information supplied.


For questions, suggestions or special requests, send e-mail to DevUtils@eProcessingNetwork.Com

 

 

Copyright © 2000 - 2009 eProcessing Network, LLC. All Rights Reserved.