Linking to eWAY

CVN Overview

Further authenticate your customers’ online credit card purchases by including a CVN field during the payment process.

Shared Payments CVN

Further minimise your risk of fraudulent transactions by authenticating your customer’s credit card with CVN details during the payment process. The credit card CVN is a three digit verification number that is found on the back of a MasterCard or VISA credit card, or a four digit number for AMEX cards.

The gateway URL is: https://www.eway.com.au/gateway_cvn/payment.asp

Linking to eWAY

Below are the specifications for using the eWAY Merchant Hosted Payment solution, including fields sent and returned by the gateway and field descriptions.

eWAY Fields Sent	Maximum Field Length (Characters)	Required Fields
ewayCustomerID	8
ewayTotalAmount	12
ewayCustomerFirstName	50
ewayCustomerLastName	50
ewayCustomerEmail	50
ewayCustomerAddress	255
ewayCustomerPostcode	6
ewayCustomerInvoiceDescription	255
ewayCustomerInvoiceRef	50
ewayTrxnNumber	16
ewayOption1	255
ewayOption2	255
ewayOption3	255
ewayAutoRedirect	1

eWAY Fields Returned	Maximum Field Length (Characters)	Required Fields
ewayTrxnStatus	6
ewayTrxnNumber	16
ewayTrxnReference	50
ewayOption1	255
ewayOption2	255
ewayOption3	255
ewayAuthCode	6
ewayReturnAmount	12
ewayTrxnError	100

eWAY Field Name	Description
ewayCustomerID	Your unique eWAY customer ID assigned to you when you join eWAY. eg 11438715
ewayTotalAmount	The total amount in cents for the transaction, eg $1.00 = 100
ewayCustomerFirstName	The first name of your customer making a purchase at your site.
ewayCustomerLastName	The last name of your customer making a purchase at your site.
ewayCustomerEmail	The email address of your customer making a purchase at your site.
ewayCustomerAddress	The address of your customer making a purchase at your site including state, city and country.
ewayCustomerPostcode	The postcode of your customer making a purchase at your site.
ewayCustomerInvoiceDescription	A description of the products or services purchased.
ewayCustomerInvoiceRef	A reference to your own invoice system for the purchase.
ewayTrxnReference	See 'eWAYTrxnNumber'.
ewayOption1	This value is returned to your website. An additional field for you to pass and receive information from eWAY.
ewayOption2	This value is returned to your website. An additional field for you to pass and receive information from eWAY.
ewayOption3	This value is returned to your website. An additional field for you to pass and receive information from eWAY.
ewayTrxnStatus	This value is returned to your website. For a successful transaction "True" is passed and for a failed transaction "False" is passed. This allows you to make your own logging on your website for transaction status.
ewayTrxnNumber	This value is returned to your website. You can pass a unique transaction number from your site. You can update and track the status of a transaction when eWAY returns to your site. NB. This number is returned as 'ewayTrxnReference'. The number returned as 'ewayTrxnNumber', is actually the unique eWAY Transaction number, created by eWAY itself.
ewayAuthCode	If the transaction is successful, this is the bank authorisation number. This is also sent in the email receipt.
eWAYReturnAmount	Can be used a check that the transaction is processed for the same amount as you request from your website.
ewayTxnError	This is the response returned by the bank, and can be related to both successful and failed transactions.

Example HTML

The following fields are recommended to be passed to eWAY

We have provided sample code for ASP, PHP, C++, JAVA, ASP.NET (C#) and VB.NET programming languages.

Basically, all you need to do, per transaction, is:

Send the XML document via HTTPS, using SSL.
Parse the XML document returned from eWAY.

ASP Code
- The URL the form tag must post to eWAY gateway payment page is
  https://www.eway.com.au/gateway_cvn/payment.asp
  
  ASP Code sample - copy and paste, then modify values using form elements or a querystring.
  
  <% 'set this infromation from your shopping cart or database 'your eWAY customer details ewayCustomerID = "87654321" 'amount in cents, here we have 10c ewayTotalAmount = "10" 'order details ewayCustomerFirstName = "Roxarne" ewayCustomerLastName = "Paton" ewayCustomerEmail = "sales@eway.com.au" ewayCustomerAddress = "18 Mayne Street Parkes NSW" ewayCustomerPostcode = "2870" ewayCustomerInvoiceDescription = "ASP code e-postcard" ewayCustomerInvoiceRef = "webactive002" ewayURL = "http://www.webactive.com.au/eway/result.asp" ewaySiteTitle = "WebActive" ewayAutoRedirect = "1" 'additional information you can pass eWAYoption1 = "book" eWAYoption2 = "section1.xls" eWAYoption3 = "" eWAYCVN = "123" ewayTrxnNumber = "2323" %> <table border="1" width="70%" cellspacing="0" cellpadding="5" bordercolor="#000080"> <tr> <td width="22%" valign="top"><p class="subtitle"><a href="http://www.eway.com.au" target="_blank"><img alt="eWAY - a total e commerce solution" border="0" height="91" src="http://www.eway.com.au/images/logos/eway.gif" width="200" /></a><p><p></p></td> <td width="78%" valign="top" bgcolor="#ffffff"> <form method="post" action="https://www.eway.com.au/gateway_cvn/payment.asp"> <input type="hidden" name="ewayCustomerID" value="<%=CStr(ewayCustomerID)%>" /> <input type="hidden" name="ewayTotalAmount" value="<%=CStr(ewayTotalAmount)%>" /> <input type="hidden" name="ewayCustomerFirstName" value="<%=CStr(ewayCustomerFirstName)%>" /> <input type="hidden" name="ewayCustomerLastName" value="<%=CStr(ewayCustomerLastName)%>" /> <input type="hidden" name="ewayCustomerEmail" value="<%=CStr(ewayCustomerEmail)%>" /> <input type="hidden" name="ewayCustomerAddress" value="<%=CStr(ewayCustomerAddress)%>" /> <input type="hidden" name="ewayCustomerPostcode" value="<%=CStr(ewayCustomerPostcode)%>" /> <input type="hidden" name="ewayCustomerInvoiceDescription" value="<%=CStr(ewayCustomerInvoiceDescription)%>" /> <input type="hidden" name="ewayCustomerInvoiceRef" value="<%=CStr(ewayCustomerInvoiceRef)%>" /> <input type="hidden" name="ewayURL" value="<%=CStr(ewayURL)%>" /> <input type="hidden" name="ewaySiteTitle" value="<%=CStr(ewaySiteTitle)%>" /> <input type="hidden" name="ewayAutoRedirect" value="<%=CStr(ewayAutoRedirect)%>" /> <input type="hidden" name="eWAYoption1" value="<%=CStr(eWAYoption1)%>" /> <input type="hidden" name="eWAYoption2" value="<%=CStr(eWAYoption2)%>" /> <input type="hidden" name="eWAYoption3" value="<%=CStr(eWAYoption3)%>" /> <input type="hidden" name="eWAYCVN" value="<%=CStr(eWAYCVN)%>" /> <input type="hidden" name="ewayTrxnNumber" value="<%=CStr(ewayTrxnNumber)%>" /> <p><input type="submit" value="Process Secure Credit Card Transaction using eWAY" name="submit" /><p><p></p> </form> </td> </tr> </table>
  
  ASP Code sample - result page on YOUR site.
  
  <%result = Request("ewayTrxnStatus") trxnReference = Request("ewayTrxnReference") transaction_number = Request("ewayTrxnNumber") if transaction_number = "" then transaction_number = "NOT DEFINED" end if option1 = Request("ewayoption1") option2 = Request("ewayoption2") option3 = Request("ewayoption3") %> <table border="1" width="70%" cellspacing="0" cellpadding="5" bordercolor="#000080"> <tr> <td width="22%" valign="top"><p class="subtitle"> <a href="http://www.eway.com.au" target="_blank"> <img alt="eWAY - a total e commerce solution" border="0" height="91" src="http://www.eway.com.au/images/logos/eway.gif" width="200" /> </a><p></p> </td> <td width="78%" valign="top" bgcolor="#ffffff"> <p>Transaction status is <b><%=result%></b> for transaction <b><%=CStr(trxnReference) %></b>, your reference is <b><%=CStr(transaction_number) %></b> The following additional information was passed <br /> option1 <b><%= CStr(option1) %></b><br /> option2 <b><%= CStr(option2) %></b><br /> option3 <b><%= CStr(option3) %></b> <p></p><a href="http://www.eway.com.au">Return to eWAY website</a> </td> </tr> </table>
PHP Code
- The URL the form tag must post to eWAY gateway payment page is
  https://www.eway.com.au/gateway_cvn/payment.asp
  
  » Download the Shared PHP sample code (with CVN support)
C# Code
- The URL the form tag must post to eWAY gateway payment page is
  https://www.eway.com.au/gateway_cvn/payment.asp
  
  » Download the Shared C# sample code (with CVN support)
VB.NET Code
- The URL the form tag must post to eWAY gateway payment page is
  https://www.eway.com.au/gateway_cvn/payment.asp
  
  » Download the Shared VB.NET sample code (with CVN support)
Perl - Linux/UNIX
- The URL the form tag must post to eWAY gateway payment page is...
  https://www.eway.com.au/gateway_cvn/payment.asp
  
  PERL sample - copy and paste, then modify values using form elements or a querystring
  
  #!/usr/local/bin/perl $ewayCustomerID = "87654321" $ewayTotalAmount = "9100" $cust_firstname = "John"; $cust_lastname = "Smith"; $cust_email = "somebody\@somewhere.com"; $cust_address = "38 Paton Street Parkes NSW"; $cust_postcode = "3029"; $cust_invoiceref = "432432"; $invc_descript = "1 Blue Sock"; $invc_option1 = "Cotton Material"; $return_url = "http://thissite.com/blah.pl"; $site_title = "This Site Name"; $cvn = "123" print "Content-type: text/html\n\n"; print <<html_end; <table border="1" width="70%" cellspacing="0" cellpadding="5" bordercolor="#000080"> <tr> <td width="22%" valign="top"><p class="subtitle"> <a href="http://www.eway.com.au" target="_blank"> <img alt="eWAY - a total e commerce solution" border="0" height="91" src="../images/logos/eway.gif" width="200" /> </a></td> <td width="78%" valign="top" bgcolor="#ffffff"> <form method="post" action="https://www.eway.com.au/gateway_cvn/payment.asp"> <input type="hidden" name="ewayCustomerID" value="$ewayCustomerID" /> <input type="hidden" name="ewayTotalAmount" value="$ewayTotalAmount" /> <input type="hidden" name="ewayCustomerFirstName" value="$cust_firstname" /> <input type="hidden" name="ewayCustomerLastName" value="$cust_lastname" /> <input type="hidden" name="ewayCustomerEmail" value="$cust_email" /> <input type="hidden" name="ewayCustomerAddress" value="$cust_address" /> <input type="hidden" name="ewayCustomerPostcode" value="$cust_postcode" /> <input type="hidden" name="ewayCustomerInvoiceDescription" value="$invc_descript" /> <input type="hidden" name="ewayCustomerInvoiceRef" value="$cust_invoiceref" /> <input type="hidden" name="ewayOption1" value="$invc_option1" /> <input type="hidden" name="ewayCVN" value="$cvn" /> <input type="hidden" name="ewayURL" value="$return_url" /> <input type="hidden" name="ewaySiteTitle" value="$site_title" /> <input type="submit" value="Process Transaction" name="submit" /><p></p> </form> </td> </tr> </table> HTML_END
  
  PERL Code sample - result page on YOUR site.
  
  #!/usr/local/bin/perl use CGI qw/:standard/; print "Content-type: text/html\n\n"; $trxn_status = lc(param('ewayTrxnStatus')); if($trxn_status =~ /true/) { $message = "Success! Your transaction was completed. Thankyou for your business."; } elsif($trxn_status =~ /false/) { $message = "Sorry, your transaction was not processed."; } else { # Something strange happened, we didn't get # any result at all. $message = "Um... something is not configured right!"; } print <<html_section> <head> <title>Page Title</title> </head> <p>$message<p></p> <p class="bodytextnormal"> <p class="bodytextnormal"> <tr align=center> <td valign="middle" align="center" class="footertext" colspan="4"> <table> <tr> <td align=center> <font face="Arial, Helvetica, sans-serif" size="1" color="#999999"> <a href="../login/default.aspx" class="footertextlink">Login</a> <font color="#FFCC33">|</font> <a href="../ssl/ssl.aspx" class="footertextlink">ssl certs</a> <font color="#FFCC33">|</font> <a href="../services/default.aspx" class="footertextlink">Services</a> <font color="#FFCC33">|</font> <a href="../services/default.aspx" class="footertextlink">Features</a> <font color="#FFCC33">|</font> <a href="../support/default.aspx" class="footertextlink">Support</a> <font color="#FFCC33">|</font> <a href="../about/default.aspx" class="footertextlink">About eWAY</a> <font color="#FFCC33">|</font> <a href="../partner/default.aspx" class="footertextlink">Partners Program</a> <font color="#FFCC33">|</font> <a href="../join/default.aspx" class="footertextlink">Join eWAY</a> <font color="#FFCC33">|</font> <a href="../pricing/default.aspx" class="footertextlink">Pricing</a> <font color="#FFCC33">|</font> <a href="../demo/default.aspx" class="footertextlink">Demo</a> <font color="#FFCC33">|</font> <a href="../contact/default.aspx" class="footertextlink">Contact</a> <font color="#FFCC33">|</font> <a href="../about/jobs.aspx" class="footertextlink">Jobs @ eWAY</a> <font color="#FFCC33">|</font> <a href="../about/privacy.aspx" class="footertextlink">Privacy</a> <br /> <span class="footertext">Web Active Corporation Pty Ltd ACN 086 209 403 - Copyright 1998 - 2006 - ABN 32 086 209 403</span> </font></td> </td> <td><a href="../about/privacy.asp"> <img border="0" src="../images/truste/finalmark.gif" width="116" height="31" /></a></td> </tr> </table> </tr> HTML_SECTION
ColdFusion
- The URL the form tag must post to eWAY gateway payment page is...
  https://www.eway.com.au/gateway_cvn/payment.asp
  
  Below is an example of the Cold Fusion code required to link to eWAY.
  
  Cold Fusion Code sample - copy and paste, then modify values using form elements or a querystring.
  
  <head> <title>eWAY Linking Code</title> </head>   <cfparam name="ewayCustomerID" default="87654321">  <cfparam name="ewayTotalAmount" default="10">  <cfparam name="ewayCustomerFirstName" default="Roxarne"> <cfparam name="ewayCustomerLastName" default="Paton"> <cfparam name="ewayCustomerEmail" default="sales@eway.com.au"> <cfparam name="ewayCustomerAddress" default="18 Mayne Street Parkes NSW"> <cfparam name="ewayCustomerPostcode" default="2870"> <cfparam name="ewayCustomerInvoiceDescription" default="ASP code e-postcard"> <cfparam name="ewayCustomerInvoiceRef" default="webactive002"> <cfparam name="ewayURL" default="http://www.webactive.com.au/eway/result.asp"> <cfparam name="ewaySiteTitle" default="WebActive"> <cfparam name="ewayAutoRedirect" default="1">  <cfparam name="ewayoption1" default="book"> <cfparam name="ewayoption2" default="section1.xls"> <cfparam name="ewayoption3" default="card"> <cfparam name="ewayTrxnNumber" default="2323"> <cfparam name="ewayCVN" default="123"> <table width="70%" border="1" cellpadding="5" align="center" bordercolor="#000080"> <tr> <td width="22%" valign="top"> <a href="http://www.eway.com.au"> <img alt="eWAY - a total e-commerce solution" border="0" height = "91" src="http://www.eway.com.au/images/logos/eway.gif" width="200" /> </a></td> <td width="78%" valign="top" bgcolor="#ffffff"> <form method="post" action="https://www.eway.com.au/gateway_cvn/payment.asp"> <input type="hidden" name="ewayCustomerID" value="<cfoutput>#ewayCustomerID#</cfoutput>" /> <input type="hidden" name="ewayTotalAmount" value="<cfoutput>#ewayTotalAmount#</cfoutput>" /> <input type="hidden" name="ewayCustomerFirstName" value="<cfoutput>#ewayCustomerFirstName#</cfoutput>" /> <input type="hidden" name="ewayCustomerLastName" value="<cfoutput>#ewayCustomerLastName#</cfoutput>" /> <input type="hidden" name="ewayCustomerEmail" value="<cfoutput>#ewayCustomerEmail#</cfoutput>" /> <input type="hidden" name="ewayCustomerAddress" value="<cfoutput>#ewayCustomerAddress#</cfoutput>" /> <input type="hidden" name="ewayCustomerPostcode" value="<cfoutput>#ewayCustomerPostcode#</cfoutput>" /> <input type="hidden" name="ewayCustomerInvoiceDescription" value="<cfoutput>#ewayCustomerInvoiceDescription#</cfoutput>" /> <input type="hidden" name="ewayCustomerInvoiceRef" value="<cfoutput>#ewayCustomerInvoiceRef#</cfoutput>" /> <input type="hidden" name="ewayURL" value="<cfoutput>#ewayURL#</cfoutput>" /> <input type="hidden" name="ewaySiteTitle" value="<cfoutput>#ewaySiteTitle#</cfoutput>" /> <input type="hidden" name="ewayAutoRedirect" value="<cfoutput>#ewayAutoRedirect#</cfoutput>" /> <input type="hidden" name="ewayoption1" value="<cfoutput>#ewayoption1#</cfoutput>" /> <input type="hidden" name="ewayoption2" value="<cfoutput>#ewayoption2#</cfoutput>" /> <input type="hidden" name="ewayoption3" value="<cfoutput>#ewayoption3#</cfoutput>" /> <input type="hidden" name="ewayTrxnNumber" value="<cfoutput>#ewayTrxnNumber#</cfoutput>" /> <input type="hidden" name="ewayCVN" value="<cfoutput>#ewayCVN#</cfoutput>" /> <p><input type="submit" value="Process Secure Credit Card Transaction using eWAY" name="submit" /><p></p> </form> </td> </tr> </table> <p class="bodytextnormal"> <p class="bodytextnormal"> <tr align=center> <td valign="middle" align="center" class="footertext" colspan="4"> </tr>
  
  Cold Fusion Code sample - result page on YOUR site
  
  <head> <title>eWAY Result Code</title> </head>  <cfparam name="TrxnStatus" default=(FORM.ewayTrxnStatus)> <cfparam name="TrxnReference" default=(FORM.ewayTrxnReference)> <cfparam name="TrxnNumber" default=(FORM.ewayTrxnNumber)> <cfparam name="option1" default=(FORM.ewayoption1)> <cfparam name="option2" default=(FORM.ewayoption2)> <cfparam name="option3" default=(FORM.ewayoption3)> <table border="1" width="70%" cellspacing="0" cellpadding="5" bordercolor="#000080"> <tr> <td width="22%" valign="top"><p class="subtitle"> <a href="http://www.eway.com.au" target="_blank"> <img alt="eWAY - a total e commerce solution" border="0" height="91" src="http://www.eway.com.au/images/logos/eway.gif" width="200" /> </a><p></p> </td> <td width="78%" valign="top" bgcolor="#ffffff"> <p>Transaction status is <b><cfoutput>#TrxnStatus#</cfoutput></b> for transaction <b><cfoutput>#TrxnReference#</cfoutput></b>, your reference is <b><cfoutput>#TrxnNumber#</cfoutput></b> The following additional information was passed <br /> option1 <b><cfoutput>#option1#</cfoutput></b><br /> option2 <b><cfoutput>#option2#</cfoutput></b><br /> option3 <b><cfoutput>#option3#</cfoutput></b> <p></p><a href="http://www.eway.com.au">Return to eWAY website</a> </td> </tr> </table> <p class="bodytextnormal"> <p class="bodytextnormal"> <tr align=center> <td valign="middle" align="center" class="footertext" colspan="4"> <table> <tr> <td align=center> <font face="Arial, Helvetica, sans-serif" size="1" color="#999999"> <a href="../login/default.aspx" class="footertextlink">Login</a> <font color="#FFCC33">|</font> <a href="../ssl/ssl.aspx" class="footertextlink">ssl certs</a> <font color="#FFCC33">|</font> <a href="../services/default.aspx" class="footertextlink">Services</a> <font color="#FFCC33">|</font> <a href="../services/features.aspx" class="footertextlink">Features</a> <font color="#FFCC33">|</font> <a href="../support/default.aspx" class="footertextlink">Support</a> <font color="#FFCC33">|</font> <a href="../about/default.aspx" class="footertextlink">About eWAY</a> <font color="#FFCC33">|</font> <a href="../partner/default.aspx" class="footertextlink">Partners Program</a> <font color="#FFCC33">|</font> <a href="../join/default.aspx" class="footertextlink">Join eWAY</a> <font color="#FFCC33">|</font> <a href="../pricing/default.aspx" class="footertextlink">Pricing</a> <font color="#FFCC33">|</font> <a href="../demo/default.aspx" class="footertextlink">Demo</a> <font color="#FFCC33">|</font> <a href="../contact/default.aspx" class="footertextlink">Contact</a> <font color="#FFCC33">|</font> <a href="../about/jobs.aspx" class="footertextlink">Jobs @ eWAY</a> <font color="#FFCC33">|</font> <a href="../about/privacy.aspx" class="footertextlink">Privacy</a> <br /> <span class="footertext">Web Active Corporation Pty Ltd ACN 086 209 403 - Copyright 1998 - 2006 - ABN 32 086 209 403</span> </font></td> </td> <td><a href="../about/privacy.asp"> <img border="0" src="../images/truste/finalmark.gif" width="116" height="31" /></a></td> </tr> </table> </tr>

You can build and test your site to link to eWAY before you have joined. All you need to do is pass the required test account information. This uses the real payment page so there is little changes required once you have joined eWAY.

In order to test the Shared Payment solution you will need to pass the following information:

CustomerID: 87654321
Test Credit Card: 4444333322221111
Result: The transaction result is based on the CENT value of the transaction for more information see the testing section.

The gateway URL is: https://www.eway.com.au/gateway_cvn/payment.asp

A successful transaction returns (Example):

ewayTrxnStatus = "True"
ewayTrxnReference = "1010054" (Varies)
eWAYresponseCode = "08"
eWAYresponseText = "TRANSACTION APPROVED(Test Gateway)"
eWAYAuthCode = "123456"

While a failed transaction returns (Example):

ewayTrxnStatus = "False"
ewayTrxnReference = "1010055" (Varies)
eWAYresponseCode = "31"
eWAYresponseText = "CARD NOT VALID(Test Gateway)"
eWAYAuthCode = ""

PLEASE MAKE SURE YOU PASS YOUR ewayCustomerID or the eWAYTESTID of "87654321" ONLY - passing any other ID may result in funds being deposited into another bank account other than your own.