3DSecure

The eWAY 3-D Secure Solution is only available as a Shared Payment Page solution - i.e. Your customer must be transferred to an eWAY payment page to enter their card details and 3-D Secure Password.

Linking to eWAY

Below are the specifications for the eWAY 3-D Secure payment page, including linking requirements and field explanations. As a minimum you must pass YOUR eWAYCustomerID and the eWAYTotalAmount of the transaction. We also strongly recommended that you pass a eWAYTrxnNumber to help reconcile your bank accounts.

N.B. The field names and specifications for the 3-D Secure Payment Page is exactly the same as the Shared Payment Page, only the URL that the FORM is POSTed to is changed.

The following table outlines the maximum string lengths that can be passed to the eWAY 3-D Secure payment page. If data is passed of a greater length then it is ignored.

eWAY fields Sent	Maximum Field Length (Characters)	Required Fields
ewayCustomerID	8
ewayTotalAmount	12
ewayCustomerFirstName	50
ewayCustomerLastName	50
ewayCustomerEmail	50
ewayCustomerAddress	255
ewayCustomerPostcode	6
ewayCustomerInvoiceDescription	10000
ewayCustomerInvoiceRef	50
eWAYURL	255
eWAYSiteTitle	255
eWAYTrxnNumber	16
ewayOption1	255
ewayOption2	255
ewayOption3	255

eWAY fields Returned	Maximum Field Length (Characters)	Returned Fields
ewayTrxnStatus	6
ewayTrxnNumber	16
eWAYresponseCode	16
eWAYresponseText	16
ewayTrxnReference	16
eWAYoption1	255
eWAYoption2	255
eWAYoption3	255
ewayAuthCode	6
eWAYReturnAmount	12

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
eWAYURL	The URL of a page on your site. Once the transaction is complete the user can easily return to your site
eWAYSiteTitle	The name of your website will be displayed on the Shared Page for the user to see.
eWAYAutoRedirect	Once a transaction is complete the user is automatically forwarded to the eWAYURL, where the results of the transaction can be logged and displayed. Pass "1" to enable, any other value disables this feature.
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
eWAYresponseCode	The status code of a transaction returned from the bank. See response code page for details
eWAYresponseText	A text message describing the status of a transactions returned from the bank. See response code page for details
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
ewayTrxnReference	This value is returned to your website. It contains a unique eWAY transaction number. This number can then be used to query any transaction in the future if required
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

Example HTML.
The following fields are recommended to be passed to eWAY. Note: For LINUX users the correct case of fields is documented in our PERL example.

<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>
    </td>
    <td width="78%" valign="top" bgcolor="

#ffffff">

<form method="post" action="https:

//www.eway.com.au/gateway_3d/payment.asp">

        <input type="hidden" name="ewayCustomerID" value="87654321" />
        <input type="hidden" name="ewayTotalAmount" value="10" />
        <input type="hidden" name="ewayCustomerFirstName" value="Roxarne" />
        <input type="hidden" name="ewayCustomerLastName" value="Paton" />
        <input type="hidden" name="ewayCustomerEmail" value="sales@eway.com.au" />
        <input type="hidden" name="ewayCustomerAddress" value="18 Mayne Street Parkes NSW" />
        <input type="hidden" name="ewayCustomerPostcode" value="2870" />
        <input type="hidden" name="ewayCustomerInvoiceDescription" value="ASP code e-postcard" />
        <input type="hidden" name="ewayCustomerInvoiceRef" value="webactive002" />
        <input type="hidden" name="ewayURL" value="http:

//www.webactive.com.au/eway/result.asp" />