Stored

Linking to eWAY
Below are the specifications for using the eWAY XML solution, including linking requirements and field descriptions.

The following table outlines the maximum string lengths that can be passed to the eWAY XML payment page.
If data of greater length is passed then it is truncated.

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
ewayCardHoldersName	50
ewayCardNumber	20
ewayCardExpiryMonth	2
ewayCardExpiryYear	2
ewayTrxnNumber	16
ewayOption1	255
ewayOption2	255
ewayOption3	255

eWAY Fields Returned	Maximum Field Length (Characters)	Required Fields
ewayTrxnStatus	6
ewayTrxnNumber	16
ewayTrxnReference	50
ewayTrxnOption1	255
ewayTrxnOption2	255
ewayTrxnOption3	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 XML Layout.
Please do not copy/paste the code behind the following XML example for your code. This will result in malformed code, as it is presented here for display purposes only. Please refer to our sample code for more information.

The following is an example of the XML sent to the eWAY XML payment page.

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

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

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

There is currently no test account for this facility. Transactions are not processed immediately with this facility, so to test its functionality you should use the Live gateway. Transactions can then be deleted through the eWAY administration area . Stored transactions incur no fee until they are processed.

The Live gateway address is:

• Live gateway- https://www.eway.com.au/gateway/xmlstored.asp

Below are the specifications for the eWAY Shared payment, 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.

The following table outlines the maximum string lengths that can be passed to the eWAY shared 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

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.

You can link with any of the following languages that support HTML FORMS using the POST method. If there are any other solutions required, please contact us.