eWAY API


3D-Secure

3D-Secure provides an additional security measure for customers and merchants.

Customers with 3D-Secure activated on their credit card will be directed via HTML FORM POST to a webpage hosted by their bank to further authenticate their payment and protect their credit card.

Linking to eWAY

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

eWAY Fields Sent Maximum Field Length (Characters) Required Fields
ewayCustomerID 8 Included
ewayTotalAmount 12 Included
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 Included
ewayTrxnNumber 16 Included
eWAYresponseCode 16 Included
eWAYresponseText 16 Included
ewayTrxnReference 50 Included
ewayTrxnOption1 255 Included
ewayTrxnOption2 255 Included
ewayTrxnOption3 255 Included
ewayAuthCode 6 Included
ewayReturnAmount 12 Included
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.
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